Não chamar chamadas relatadas (Editor Independente) (versão prévia)
O ponto de extremidade da API de Dados de Chamadas Relatadas do DNC (Não Chamar) fornece dados todos os dias da semana sobre reclamações de Não Chamar e robocall relatadas à Comissão Federal de Comércio. Esses dados consistem em informações relatadas pelos consumidores, incluindo o número de telefone originário da chamada indesejada, a data em que a reclamação foi criada, a hora em que a chamada foi feita, as localizações da cidade e do estado do consumidor relatadas, o assunto da chamada e se a chamada foi um robocall. As chamadas relatadas não são verificadas.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| ttaylor@hitachisolutions.com |
| Metadados do conector | |
|---|---|
| Publicador | Troy Taylor, Hitachi Solutions |
| Site | https://www.ftc.gov/developer/api/v0/endpoints/do-not-call-dnc-reported-calls-data-api |
| Política de privacidade | https://www.ftc.gov/site-information/privacy-policy |
| Categorias | Dados; Comunicação |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | secureString | A chave de API para esta api | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Listar todas as reclamações do DNC |
Retorna uma lista de reclamações não verificadas com base nos parâmetros de filtro. |
| Obter uma única reclamação do DNC |
Retorna uma única reclamação não verificada por ID. |
Listar todas as reclamações do DNC
Retorna uma lista de reclamações não verificadas com base nos parâmetros de filtro.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Data de criação
|
created_date | string |
Filtre registros por uma data específica em que as reclamações foram criadas durante. Por exemplo, mostre todas as reclamações criadas em 26 de fevereiro de 2020: 2020-02-26 |
|
|
Data criada a partir de
|
created_date_from | string |
Filtre registros por um intervalo de datas/horas em que as reclamações foram criadas. Esses filtros devem ser usados juntos. Pode ser combinado com qualquer um desses filtros: Estado, Código de Área ou Robocall. Quando combinado com o filtro de estado, um filtro de cidade opcional pode ser adicionado. |
|
|
Data de criação para
|
created_date_to | string |
Filtre registros por um intervalo de datas/horas em que as reclamações foram criadas. Esses filtros devem ser usados juntos. Pode ser combinado com qualquer um desses filtros: Estado, Código de Área ou Robocall. Quando combinado com o filtro de estado, um filtro de cidade opcional pode ser adicionado. |
|
|
Data da violação
|
violation_date | string |
Filtre registros por uma data específica em que chamadas indesejadas foram recebidas durante. Por exemplo, mostre todas as chamadas indesejadas recebidas em 26 de fevereiro de 2020: 2020-02-26 |
|
|
Data da violação de
|
violation_date_from | string |
Filtre registros por um intervalo de datas/horas em que as violações foram criadas. Esses filtros devem ser usados juntos. Pode ser combinado com qualquer um desses filtros: Estado, Código de Área ou Robocall. Quando combinado com o filtro de estado, um filtro de cidade opcional pode ser adicionado. |
|
|
Data de violação para
|
violation_date_to | string |
Filtre registros por um intervalo de datas/horas em que as violações foram criadas. Esses filtros devem ser usados juntos. Pode ser combinado com qualquer um desses filtros: Estado, Código de Área ou Robocall. Quando combinado com o filtro de estado, um filtro de cidade opcional pode ser adicionado. |
|
|
Estado
|
state | string |
Filtrar registros por um estado do qual as reclamações se originaram. Pode ser combinado com os filtros data/data de criação/cidade. |
|
|
City
|
city | string |
Filtrar registros de uma cidade da qual as reclamações se originaram. Esse filtro deve ser usado junto com o filtro de estado. Pode ser combinado com os filtros data de criação/data de criação para. |
|
|
Código de área
|
area_code | integer |
Filtrar registros pelo código de área do qual as reclamações se originaram. Pode ser combinado com os filtros data de criação/data de criação para. |
|
|
É Robocall
|
is_robocall | boolean |
Filtre se a chamada indesejada foi uma mensagem gravada/robocall ou não. O valor deve ser "true" ou "false". Pode ser combinado com os filtros data de criação/data de criação para. |
|
|
Ordem de Classificação
|
sort_order | string |
Direção de classificação a ser usada com o parâmetro sort_by. |
|
|
Itens por Página
|
items_per_page | integer |
Número máximo de registros a serem incluídos na resposta. Por padrão, o ponto de extremidade exibe um máximo de 50 registros por solicitação. Esse também é o valor máximo permitido. |
|
|
Offset
|
offset | integer |
Deslocamento por vários registros, permitindo que uma determinada seção de resultados paginados seja solicitada (use com o parâmetro Items por Página). |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Dados
|
data | array of object | |
|
Tipo
|
data.type | string |
O tipo de registro, "dnc_complaint". |
|
ID
|
data.id | string |
O identificador exclusivo do registro. |
|
Número de telefone da empresa
|
data.attributes.company-phone-number | string |
O número de telefone do qual a chamada indesejada se originou. |
|
Data de criação
|
data.attributes.created-date | string |
A data/hora em que a reclamação foi criada. O formato de carimbo de data/hora é ISO 8601. Exemplo: 1997-07-16T19:20:30+01:00 |
|
Data da violação
|
data.attributes.violation-date | string |
A data/hora em que a chamada indesejada foi recebida. O formato de carimbo de data/hora é ISO 8601. |
|
Cidade do Consumidor
|
data.attributes.consumer-city | string |
A cidade relatou pelo consumidor que criou a reclamação. |
|
Estado do consumidor
|
data.attributes.consumer-state | string | |
|
Código da área do consumidor
|
data.attributes.consumer-area-code | string |
O código de área do consumidor que criou a reclamação. |
|
Assunto
|
data.attributes.subject | string |
O assunto da chamada indesejada. |
|
Mensagem gravada ou Robocall
|
data.attributes.recorded-message-or-robocall | string |
Indica se a chamada indesejada foi uma mensagem gravada/robocall ("Y" ou não ("N"). |
|
Link
|
data.links.self | string |
Um link que pertence a esse registro. |
|
Registra esta página
|
meta.records-this-page | integer |
O número de registros incluídos nessa resposta. |
|
Total de Registros
|
meta.record-total | integer |
O número total de registros encontrados para a solicitação. |
|
Link
|
links.self | string |
Um link que pertence a esse registro. |
Obter uma única reclamação do DNC
Retorna uma única reclamação não verificada por ID.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
O identificador exclusivo da reclamação. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Dados
|
data | array of object | |
|
Tipo
|
data.type | string |
O tipo de registro, "dnc_complaint". |
|
ID
|
data.id | string |
O identificador exclusivo do registro. |
|
Número de telefone da empresa
|
data.attributes.company-phone-number | string |
O número de telefone do qual a chamada indesejada se originou. |
|
Data de criação
|
data.attributes.created-date | string |
A data/hora em que a reclamação foi criada. O formato de carimbo de data/hora é ISO 8601. Exemplo: 1997-07-16T19:20:30+01:00 |
|
Data da violação
|
data.attributes.violation-date | string |
A data/hora em que a chamada indesejada foi recebida. O formato de carimbo de data/hora é ISO 8601. |
|
Cidade do Consumidor
|
data.attributes.consumer-city | string |
A cidade relatou pelo consumidor que criou a reclamação. |
|
Estado do consumidor
|
data.attributes.consumer-state | string | |
|
Código da área do consumidor
|
data.attributes.consumer-area-code | string |
O código de área do consumidor que criou a reclamação. |
|
Assunto
|
data.attributes.subject | string |
O assunto da chamada indesejada. |
|
Mensagem gravada ou Robocall
|
data.attributes.recorded-message-or-robocall | string |
Indica se a chamada indesejada foi uma mensagem gravada/robocall ("Y" ou não ("N"). |
|
Link
|
data.links.self | string |
Um link que pertence a esse registro. |
|
Registra esta página
|
meta.records-this-page | integer |
O número de registros incluídos nessa resposta. |
|
Total de Registros
|
meta.record-total | integer |
O número total de registros encontrados para a solicitação. |
|
Link
|
links.self | string |
Um link que pertence a esse registro. |