보고된 호출을 호출하지 않음(독립 게시자)(미리 보기)
통화 안 함(DNC) 보고된 통화 데이터 API 엔드포인트는 평일 연방 거래위원회에 보고된 통화 안 함 및 로보콜 불만에 대한 데이터를 제공합니다. 이 데이터는 원치 않는 전화를 시작한 전화 번호, 불만 제기 날짜, 통화가 이루어진 시간, 보고된 소비자의 도시 및 주 위치, 통화 대상 및 통화가 로보콜인지 여부를 포함하여 소비자가 보고한 정보로 구성됩니다. 보고된 호출이 확인되지 않습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | 트로이 테일러 |
| URL | https://www.hitachisolutions.com |
| 전자 메일 | ttaylor@hitachisolutions.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | 트로이 테일러, 히타치 솔루션 |
| 웹 사이트 | https://www.ftc.gov/developer/api/v0/endpoints/do-not-call-dnc-reported-calls-data-api |
| 개인 정보 보호 정책 | https://www.ftc.gov/site-information/privacy-policy |
| 카테고리 | 데이터; 통신 |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| API 키 | 시큐어스트링 (보안 문자열) | 이 API의 API 키 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 단일 DNC 불만 사항 가져오기 |
ID별로 확인되지 않은 단일 불만 사항을 반환합니다. |
| 모든 DNC 불만 나열 |
필터 매개 변수를 기반으로 확인되지 않은 불만 사항 목록을 반환합니다. |
단일 DNC 불만 사항 가져오기
ID별로 확인되지 않은 단일 불만 사항을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
아이디
|
id | True | string |
불만 사항의 고유 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
데이터
|
data | array of object | |
|
유형
|
data.type | string |
레코드 형식인 "dnc_complaint"입니다. |
|
아이디
|
data.id | string |
레코드 고유 식별자입니다. |
|
회사 전화 번호
|
data.attributes.company-phone-number | string |
원치 않는 전화가 시작된 전화 번호입니다. |
|
생성 날짜
|
data.attributes.created-date | string |
불만이 생성된 날짜/시간입니다. 타임스탬프 형식은 ISO 8601입니다. 예: 1997-07-16T19:20:30+01:00 |
|
위반 날짜
|
data.attributes.violation-date | string |
원치 않는 전화를 받은 날짜/시간입니다. 타임스탬프 형식은 ISO 8601입니다. |
|
소비자 도시
|
data.attributes.consumer-city | string |
이 도시는 불만을 제기 한 소비자가보고했습니다. |
|
소비자 상태
|
data.attributes.consumer-state | string | |
|
소비자 영역 코드
|
data.attributes.consumer-area-code | string |
불만을 제기한 소비자의 지역 코드입니다. |
|
주제
|
data.attributes.subject | string |
원치 않는 호출의 주체입니다. |
|
기록된 메시지 또는 Robocall
|
data.attributes.recorded-message-or-robocall | string |
원치 않는 호출이 기록된 메시지/robocall("Y")인지 여부("N")인지를 나타냅니다. |
|
Link
|
data.links.self | string |
이 레코드와 관련된 링크입니다. |
|
이 페이지 기록
|
meta.records-this-page | integer |
이 응답에 포함된 레코드 수입니다. |
|
레코드 합계
|
meta.record-total | integer |
요청에 대해 찾은 총 레코드 수입니다. |
|
Link
|
links.self | string |
이 레코드와 관련된 링크입니다. |
모든 DNC 불만 나열
필터 매개 변수를 기반으로 확인되지 않은 불만 사항 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
생성 날짜
|
created_date | string |
불만 사항이 발생한 특정 날짜를 기준으로 레코드를 필터링합니다. 예를 들어 2020년 2월 26일: 2020-02-26에 생성된 모든 불만 사항을 표시합니다. |
|
|
만든 날짜
|
created_date_from | string |
불만 사항이 생성된 날짜/시간 범위별로 레코드를 필터링합니다. 이러한 필터는 함께 사용해야 합니다. 상태, 지역 코드 또는 Robocall 필터 중 하나와 결합할 수 있습니다. 상태 필터와 결합하면 선택적 도시 필터를 추가할 수 있습니다. |
|
|
만든 날짜
|
created_date_to | string |
불만 사항이 생성된 날짜/시간 범위별로 레코드를 필터링합니다. 이러한 필터는 함께 사용해야 합니다. 상태, 지역 코드 또는 Robocall 필터 중 하나와 결합할 수 있습니다. 상태 필터와 결합하면 선택적 도시 필터를 추가할 수 있습니다. |
|
|
위반 날짜
|
violation_date | string |
원치 않는 호출이 수신된 특정 날짜를 기준으로 레코드를 필터링합니다. 예를 들어 2020년 2월 26일: 2020-02-26에 수신된 모든 원치 않는 호출을 표시합니다. |
|
|
위반 날짜
|
violation_date_from | string |
위반이 생성된 날짜/시간 범위별로 레코드를 필터링합니다. 이러한 필터는 함께 사용해야 합니다. 상태, 지역 코드 또는 Robocall 필터 중 하나와 결합할 수 있습니다. 상태 필터와 결합하면 선택적 도시 필터를 추가할 수 있습니다. |
|
|
위반 날짜
|
violation_date_to | string |
위반이 생성된 날짜/시간 범위별로 레코드를 필터링합니다. 이러한 필터는 함께 사용해야 합니다. 상태, 지역 코드 또는 Robocall 필터 중 하나와 결합할 수 있습니다. 상태 필터와 결합하면 선택적 도시 필터를 추가할 수 있습니다. |
|
|
주
|
state | string |
불만 사항이 발생한 상태로 레코드를 필터링합니다. 도시 및 만든 날짜/만든 날짜와 필터를 결합할 수 있습니다. |
|
|
도시
|
city | string |
불만이 발생한 도시별로 레코드를 필터링합니다. 이 필터는 상태 필터와 함께 사용해야 합니다. 만든 날짜/만든 날짜부터 필터로 결합할 수 있습니다. |
|
|
영역 코드
|
area_code | integer |
불만 사항이 발생한 지역 코드를 사용하여 레코드를 필터링합니다. 만든 날짜/만든 날짜부터 필터로 결합할 수 있습니다. |
|
|
Robocall인가요?
|
is_robocall | boolean |
원치 않는 호출이 기록된 메시지/robocall인지 여부를 필터링합니다. 값은 "true" 또는 "false"여야 합니다. 만든 날짜/만든 날짜부터 필터로 결합할 수 있습니다. |
|
|
정렬 순서
|
sort_order | string |
sort_by 매개 변수와 함께 사용할 방향을 정렬합니다. |
|
|
페이지당 항목 수
|
items_per_page | integer |
응답에 포함할 최대 레코드 수입니다. 기본적으로 엔드포인트는 요청당 최대 50개의 레코드를 표시합니다. 허용되는 최대값이기도 하다. |
|
|
상쇄
|
offset | integer |
페이지가 매겨진 결과의 특정 섹션을 요청할 수 있도록 여러 레코드로 오프셋합니다(페이지당 항목 매개 변수와 함께 사용). |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
데이터
|
data | array of object | |
|
유형
|
data.type | string |
레코드 형식인 "dnc_complaint"입니다. |
|
아이디
|
data.id | string |
레코드 고유 식별자입니다. |
|
회사 전화 번호
|
data.attributes.company-phone-number | string |
원치 않는 전화가 시작된 전화 번호입니다. |
|
생성 날짜
|
data.attributes.created-date | string |
불만이 생성된 날짜/시간입니다. 타임스탬프 형식은 ISO 8601입니다. 예: 1997-07-16T19:20:30+01:00 |
|
위반 날짜
|
data.attributes.violation-date | string |
원치 않는 전화를 받은 날짜/시간입니다. 타임스탬프 형식은 ISO 8601입니다. |
|
소비자 도시
|
data.attributes.consumer-city | string |
이 도시는 불만을 제기 한 소비자가보고했습니다. |
|
소비자 상태
|
data.attributes.consumer-state | string | |
|
소비자 영역 코드
|
data.attributes.consumer-area-code | string |
불만을 제기한 소비자의 지역 코드입니다. |
|
주제
|
data.attributes.subject | string |
원치 않는 호출의 주체입니다. |
|
기록된 메시지 또는 Robocall
|
data.attributes.recorded-message-or-robocall | string |
원치 않는 호출이 기록된 메시지/robocall("Y")인지 여부("N")인지를 나타냅니다. |
|
Link
|
data.links.self | string |
이 레코드와 관련된 링크입니다. |
|
이 페이지 기록
|
meta.records-this-page | integer |
이 응답에 포함된 레코드 수입니다. |
|
레코드 합계
|
meta.record-total | integer |
요청에 대해 찾은 총 레코드 수입니다. |
|
Link
|
links.self | string |
이 레코드와 관련된 링크입니다. |