Not Call Reported Calls (Independent Publisher) (Vorschau)
Der DNC-Endpunkt für gemeldete Anrufe (Do Not Call, DNC) liefert jeden Wochentag Daten zu Do Not Call- und Robocall-Beschwerden, die der Federal Trade Commission gemeldet wurden. Diese Daten bestehen aus Informationen, die von Verbrauchern gemeldet werden, einschließlich der Telefonnummer, die den unerwünschten Anruf verursacht hat, das Datum, an dem die Beschwerde erstellt wurde, die Uhrzeit des Anrufs, die Stadt und die Landesstandorte des Verbrauchers, den Betreff des Anrufs und ob der Anruf ein Robocall war. Die gemeldeten Aufrufe werden nicht überprüft.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| ttaylor@hitachisolutions.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Troy Taylor, Hitachi Solutions |
| Webseite | https://www.ftc.gov/developer/api/v0/endpoints/do-not-call-dnc-reported-calls-data-api |
| Datenschutzrichtlinie | https://www.ftc.gov/site-information/privacy-policy |
| Kategorien | Daten; Kommunikation |
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| API-Schlüssel | securestring | Der API-Schlüssel für diese API | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen einer einzelnen DNC-Beschwerde |
Gibt eine einzelne nicht überprüfte Beanstandung nach ID zurück. |
| Auflisten aller DNC-Beschwerden |
Gibt eine Liste nicht überprüfter Beschwerden basierend auf den Filterparametern zurück. |
Abrufen einer einzelnen DNC-Beschwerde
Gibt eine einzelne nicht überprüfte Beanstandung nach ID zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
ID
|
id | True | string |
Der eindeutige Bezeichner der Beschwerde. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Daten
|
data | array of object | |
|
Typ
|
data.type | string |
Der Datensatztyp "dnc_complaint". |
|
ID
|
data.id | string |
Der eindeutige Datensatzbezeichner. |
|
Firmentelefonnummer
|
data.attributes.company-phone-number | string |
Die Telefonnummer, von der der unerwünschte Anruf stammt. |
|
Erstellt am
|
data.attributes.created-date | string |
Das Datum/die Uhrzeit, zu dem die Beschwerde erstellt wurde. Das Zeitstempelformat ist ISO 8601. Beispiel: 1997-07-16T19:20:30+01:00 |
|
Verletzungsdatum
|
data.attributes.violation-date | string |
Das Datum/die Uhrzeit, zu der der unerwünschte Anruf empfangen wurde. Das Zeitstempelformat ist ISO 8601. |
|
Consumer City
|
data.attributes.consumer-city | string |
Die Stadt berichtet von dem Verbraucher, der die Beschwerde erstellt hat. |
|
Verbraucherstaat
|
data.attributes.consumer-state | string | |
|
Verbraucherbereichsvorwahl
|
data.attributes.consumer-area-code | string |
Die Vorwahl des Verbrauchers, der die Beschwerde erstellt hat. |
|
Betreff
|
data.attributes.subject | string |
Der Betreff des unerwünschten Anrufs. |
|
Aufgezeichnete Nachricht oder Robocall
|
data.attributes.recorded-message-or-robocall | string |
Gibt an, ob der unerwünschte Anruf eine aufgezeichnete Nachricht /robocall ("Y") war oder nicht ("N"). |
|
Link
|
data.links.self | string |
Ein Link, der sich auf diesen Datensatz bezieht. |
|
Zeichnet diese Seite auf
|
meta.records-this-page | integer |
Die Anzahl der Datensätze, die in dieser Antwort enthalten sind. |
|
Datensatzsumme
|
meta.record-total | integer |
Die Gesamtanzahl der Datensätze, die für die Anforderung gefunden wurden. |
|
Link
|
links.self | string |
Ein Link, der sich auf diesen Datensatz bezieht. |
Auflisten aller DNC-Beschwerden
Gibt eine Liste nicht überprüfter Beschwerden basierend auf den Filterparametern zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Erstellt am
|
created_date | string |
Filtert Datensätze nach einem bestimmten Datum, an dem Beschwerden erstellt wurden. Zeigen Sie beispielsweise alle Beschwerden an, die am 26. Februar 2020: 2020-02-26 erstellt wurden |
|
|
Erstellungsdatum von
|
created_date_from | string |
Filtert Datensätze nach einem Bereich von Datums- und Uhrzeitangaben, die Beschwerden erstellt wurden. Diese Filter müssen zusammen verwendet werden. Kann mit jedem dieser Filter kombiniert werden: Bundesland, Vorwahl oder Is Robocall. In Kombination mit dem Statusfilter kann ein optionaler Ortsfilter hinzugefügt werden. |
|
|
Erstellungsdatum bis
|
created_date_to | string |
Filtert Datensätze nach einem Bereich von Datums- und Uhrzeitangaben, die Beschwerden erstellt wurden. Diese Filter müssen zusammen verwendet werden. Kann mit jedem dieser Filter kombiniert werden: Bundesland, Vorwahl oder Is Robocall. In Kombination mit dem Statusfilter kann ein optionaler Ortsfilter hinzugefügt werden. |
|
|
Verletzungsdatum
|
violation_date | string |
Filtert Datensätze nach einem bestimmten Datum, an dem unerwünschte Anrufe empfangen wurden. Zeigen Sie beispielsweise alle unerwünschten Anrufe an, die am 26. Februar 2020: 2020-02-26 empfangen wurden |
|
|
Verletzungsdatum von
|
violation_date_from | string |
Filtert Datensätze nach einem Bereich von Datums-/Uhrzeitangaben, die Verletzungen erstellt wurden. Diese Filter müssen zusammen verwendet werden. Kann mit jedem dieser Filter kombiniert werden: Bundesland, Vorwahl oder Is Robocall. In Kombination mit dem Statusfilter kann ein optionaler Ortsfilter hinzugefügt werden. |
|
|
Verletzungsdatum bis
|
violation_date_to | string |
Filtert Datensätze nach einem Bereich von Datums-/Uhrzeitangaben, die Verletzungen erstellt wurden. Diese Filter müssen zusammen verwendet werden. Kann mit jedem dieser Filter kombiniert werden: Bundesland, Vorwahl oder Is Robocall. In Kombination mit dem Statusfilter kann ein optionaler Ortsfilter hinzugefügt werden. |
|
|
Staat
|
state | string |
Filtert Datensätze nach einem Zustand, von dem Beschwerden stammen. Kann mit der Stadt und dem Erstellungsdatum aus / Erstellungsdatum zu Filtern kombiniert werden. |
|
|
Stadt
|
city | string |
Filtert Datensätze nach einer Stadt, aus der Beschwerden stammen. Dieser Filter muss zusammen mit dem Statusfilter verwendet werden. Kann mit dem Filter "Erstellungsdatum von/ Erstellungsdatum bis" kombiniert werden. |
|
|
Vorwahl
|
area_code | integer |
Filtern Sie Datensätze nach der Vorwahl, aus der Beschwerden stammen. Kann mit dem Filter "Erstellungsdatum von/ Erstellungsdatum bis" kombiniert werden. |
|
|
Ist Robocall
|
is_robocall | boolean |
Filtern Sie nach, ob der unerwünschte Anruf eine aufgezeichnete Nachricht /robocall war oder nicht. Der Wert muss entweder "true" oder "false" sein. Kann mit dem Filter "Erstellungsdatum von/ Erstellungsdatum bis" kombiniert werden. |
|
|
Sortierreihenfolge
|
sort_order | string |
Sortierrichtung, die mit dem sort_by-Parameter verwendet werden soll. |
|
|
Elemente pro Seite
|
items_per_page | integer |
Maximale Anzahl von Datensätzen, die als Antwort eingeschlossen werden sollen. Standardmäßig zeigt der Endpunkt maximal 50 Datensätze pro Anforderung an. Dies ist auch der maximal zulässige Wert. |
|
|
Offset
|
offset | integer |
Offset um eine Reihe von Datensätzen, sodass ein bestimmter Abschnitt mit paginierten Ergebnissen angefordert werden kann (mit dem Parameter "Items Per Page"). |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Daten
|
data | array of object | |
|
Typ
|
data.type | string |
Der Datensatztyp "dnc_complaint". |
|
ID
|
data.id | string |
Der eindeutige Datensatzbezeichner. |
|
Firmentelefonnummer
|
data.attributes.company-phone-number | string |
Die Telefonnummer, von der der unerwünschte Anruf stammt. |
|
Erstellt am
|
data.attributes.created-date | string |
Das Datum/die Uhrzeit, zu dem die Beschwerde erstellt wurde. Das Zeitstempelformat ist ISO 8601. Beispiel: 1997-07-16T19:20:30+01:00 |
|
Verletzungsdatum
|
data.attributes.violation-date | string |
Das Datum/die Uhrzeit, zu der der unerwünschte Anruf empfangen wurde. Das Zeitstempelformat ist ISO 8601. |
|
Consumer City
|
data.attributes.consumer-city | string |
Die Stadt berichtet von dem Verbraucher, der die Beschwerde erstellt hat. |
|
Verbraucherstaat
|
data.attributes.consumer-state | string | |
|
Verbraucherbereichsvorwahl
|
data.attributes.consumer-area-code | string |
Die Vorwahl des Verbrauchers, der die Beschwerde erstellt hat. |
|
Betreff
|
data.attributes.subject | string |
Der Betreff des unerwünschten Anrufs. |
|
Aufgezeichnete Nachricht oder Robocall
|
data.attributes.recorded-message-or-robocall | string |
Gibt an, ob der unerwünschte Anruf eine aufgezeichnete Nachricht /robocall ("Y") war oder nicht ("N"). |
|
Link
|
data.links.self | string |
Ein Link, der sich auf diesen Datensatz bezieht. |
|
Zeichnet diese Seite auf
|
meta.records-this-page | integer |
Die Anzahl der Datensätze, die in dieser Antwort enthalten sind. |
|
Datensatzsumme
|
meta.record-total | integer |
Die Gesamtanzahl der Datensätze, die für die Anforderung gefunden wurden. |
|
Link
|
links.self | string |
Ein Link, der sich auf diesen Datensatz bezieht. |