No llamar a llamadas notificadas (publicador independiente) (versión preliminar)
El punto de conexión de La API de datos de llamadas notificadas no llamar (DNC) proporciona datos todos los días de la semana sobre las quejas no llamar y robocall notificadas a la Comisión Federal de Comercio. Estos datos constan de información notificada por los consumidores, incluido el número de teléfono que originó la llamada no deseada, la fecha en que se creó la queja, la hora en que se realizó la llamada, la ciudad del consumidor y las ubicaciones estatales notificadas, el sujeto de la llamada y si la llamada era una llamada robocall. Las llamadas notificadas no se comprueban.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| Correo Electrónico | ttaylor@hitachisolutions.com |
| Metadatos del conector | |
|---|---|
| Publicador | Troy Taylor, Hitachi Solutions |
| Sitio web | https://www.ftc.gov/developer/api/v0/endpoints/do-not-call-dnc-reported-calls-data-api |
| Directiva de privacidad | https://www.ftc.gov/site-information/privacy-policy |
| Categorías | Datos; Comunicación |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API | securestring | La clave de API de esta API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Enumerar todas las quejas de DNC |
Devuelve una lista de quejas no comprobadas en función de los parámetros de filtro. |
| Obtención de una única queja de DNC |
Devuelve una única queja no comprobada por identificador. |
Enumerar todas las quejas de DNC
Devuelve una lista de quejas no comprobadas en función de los parámetros de filtro.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Fecha de creación
|
created_date | string |
Filtre los registros por una fecha específica durante la que se crearon quejas. Por ejemplo, muestre todas las quejas creadas el 26 de febrero de 2020: 2020-02-26 |
|
|
Fecha de creación a partir de
|
created_date_from | string |
Filtre los registros por un intervalo de fechas y horas en que se crearon quejas. Estos filtros deben usarse juntos. Se puede combinar con cualquiera de estos filtros: Estado, Código de área o Is Robocall. Cuando se combina con el filtro de estado, se puede agregar un filtro de ciudad opcional. |
|
|
Fecha de creación a
|
created_date_to | string |
Filtre los registros por un intervalo de fechas y horas en que se crearon quejas. Estos filtros deben usarse juntos. Se puede combinar con cualquiera de estos filtros: Estado, Código de área o Is Robocall. Cuando se combina con el filtro de estado, se puede agregar un filtro de ciudad opcional. |
|
|
Fecha de infracción
|
violation_date | string |
Filtre los registros por una fecha específica durante la que se recibieron llamadas no deseadas. Por ejemplo, muestre todas las llamadas no deseadas recibidas el 26 de febrero de 2020: 2020-02-26 |
|
|
Fecha de infracción a partir de
|
violation_date_from | string |
Filtre los registros por un intervalo de fechas y horas en las que se crearon infracciones. Estos filtros deben usarse juntos. Se puede combinar con cualquiera de estos filtros: Estado, Código de área o Is Robocall. Cuando se combina con el filtro de estado, se puede agregar un filtro de ciudad opcional. |
|
|
Fecha de infracción a
|
violation_date_to | string |
Filtre los registros por un intervalo de fechas y horas en las que se crearon infracciones. Estos filtros deben usarse juntos. Se puede combinar con cualquiera de estos filtros: Estado, Código de área o Is Robocall. Cuando se combina con el filtro de estado, se puede agregar un filtro de ciudad opcional. |
|
|
Estado
|
state | string |
Filtre los registros por un estado en el que se originaron las quejas. Se puede combinar con la ciudad y los filtros Fecha de creación a partir o fecha de creación. |
|
|
City
|
city | string |
Filtre los registros por una ciudad a la que se originaron las quejas. Este filtro debe usarse junto con el filtro de estado. Se puede combinar con los filtros Fecha de creación a partir o fecha de creación. |
|
|
Código de área
|
area_code | integer |
Filtre los registros por el código de área del que se originaron las quejas. Se puede combinar con los filtros Fecha de creación a partir o fecha de creación. |
|
|
Es Robocall
|
is_robocall | boolean |
Filtre por si la llamada no deseada era un mensaje grabado o robocall o no. El valor debe ser "true" o "false". Se puede combinar con los filtros Fecha de creación a partir o fecha de creación. |
|
|
Criterio de ordenación
|
sort_order | string |
Ordene la dirección que se va a usar con el parámetro sort_by. |
|
|
Elementos por página
|
items_per_page | integer |
Número máximo de registros que se van a incluir en respuesta. De forma predeterminada, el punto de conexión muestra un máximo de 50 registros por solicitud. Este también es el valor máximo permitido. |
|
|
Desplazar
|
offset | integer |
Desplazamiento por una serie de registros, lo que permite solicitar una sección determinada de resultados paginados (use con el parámetro Elementos por página). |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Data
|
data | array of object | |
|
Tipo
|
data.type | string |
Tipo de registro, "dnc_complaint". |
|
identificación
|
data.id | string |
Identificador único del registro. |
|
Número de teléfono de la empresa
|
data.attributes.company-phone-number | string |
Número de teléfono desde el que se originó la llamada no deseada. |
|
Fecha de creación
|
data.attributes.created-date | string |
Fecha y hora en que se creó la queja. El formato de marca de tiempo es ISO 8601. Ejemplo: 1997-07-16T19:20:30+01:00 |
|
Fecha de infracción
|
data.attributes.violation-date | string |
Fecha y hora en que se recibió la llamada no deseada. El formato de marca de tiempo es ISO 8601. |
|
Ciudad del consumidor
|
data.attributes.consumer-city | string |
La ciudad notificada por el consumidor que creó la queja. |
|
Estado del consumidor
|
data.attributes.consumer-state | string | |
|
Código de área de consumidor
|
data.attributes.consumer-area-code | string |
Código de área del consumidor que creó la queja. |
|
Asunto
|
data.attributes.subject | string |
El asunto de la llamada no deseada. |
|
Mensaje grabado o Robocall
|
data.attributes.recorded-message-or-robocall | string |
Indica si la llamada no deseada era un mensaje grabado o robocall ("Y"), o no ("N"). |
|
Link
|
data.links.self | string |
Vínculo que pertenece a este registro. |
|
Registra esta página
|
meta.records-this-page | integer |
Número de registros incluidos en esta respuesta. |
|
Total de registros
|
meta.record-total | integer |
Número total de registros encontrados para la solicitud. |
|
Link
|
links.self | string |
Vínculo que pertenece a este registro. |
Obtención de una única queja de DNC
Devuelve una única queja no comprobada por identificador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
identificación
|
id | True | string |
Identificador único de la queja. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Data
|
data | array of object | |
|
Tipo
|
data.type | string |
Tipo de registro, "dnc_complaint". |
|
identificación
|
data.id | string |
Identificador único del registro. |
|
Número de teléfono de la empresa
|
data.attributes.company-phone-number | string |
Número de teléfono desde el que se originó la llamada no deseada. |
|
Fecha de creación
|
data.attributes.created-date | string |
Fecha y hora en que se creó la queja. El formato de marca de tiempo es ISO 8601. Ejemplo: 1997-07-16T19:20:30+01:00 |
|
Fecha de infracción
|
data.attributes.violation-date | string |
Fecha y hora en que se recibió la llamada no deseada. El formato de marca de tiempo es ISO 8601. |
|
Ciudad del consumidor
|
data.attributes.consumer-city | string |
La ciudad notificada por el consumidor que creó la queja. |
|
Estado del consumidor
|
data.attributes.consumer-state | string | |
|
Código de área de consumidor
|
data.attributes.consumer-area-code | string |
Código de área del consumidor que creó la queja. |
|
Asunto
|
data.attributes.subject | string |
El asunto de la llamada no deseada. |
|
Mensaje grabado o Robocall
|
data.attributes.recorded-message-or-robocall | string |
Indica si la llamada no deseada era un mensaje grabado o robocall ("Y"), o no ("N"). |
|
Link
|
data.links.self | string |
Vínculo que pertenece a este registro. |
|
Registra esta página
|
meta.records-this-page | integer |
Número de registros incluidos en esta respuesta. |
|
Total de registros
|
meta.record-total | integer |
Número total de registros encontrados para la solicitud. |
|
Link
|
links.self | string |
Vínculo que pertenece a este registro. |