발신자 이름 조회
전화번호에 대해 조회 가능한 발신자 이름 결과를 가져옵니다. 실제 운영 환경에서 수행하는 조회이므로 서비스 캐시에서 결과를 가져오는 경우에도 계정에 요금이 부과될 수 있습니다. 소유한 전화번호로 발신할 때 표시되는 이름은 변경하지 않습니다.
반환된 이름은 신원이나 번호 소유권 또는 전화할 권한이 확인되었다는 뜻이 아닙니다. 이름이 없거나 오래된 정보일 수 있으며, 약칭이나 지역명이 반환되거나 대체 값으로 전화번호가 반환될 수도 있습니다.
요청
활성화된 API 계정을 사용하여 해당 계정에 허용된 출발지 IP 주소에서 접속하세요. 인증 정보는 서버 측 비밀 정보 저장소에 보관하세요. 예제에서는 환경 변수와 가상의 북미 전화번호를 사용합니다. 인증 정보를 URL이나 공개되는 브라우저 코드에 넣지 마세요.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cnam/12025550123국가 코드를 포함한 전체 번호를 숫자로만 입력하세요. 예를 들어 북미 번호는 1로 시작하는 열한 자리 번호입니다. 구분 기호나 더하기 기호를 핸들러가 정규화할 것이라고 가정하지 마세요. 요청 본문이나 지역 선택 항목은 필요하지 않습니다. 사용하려는 용도에 대한 지원 범위는 MultiTEL에 확인하세요.
응답
값은 예시일 뿐이며, 비용 값은 요금 견적이 아닙니다.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"name": "EXAMPLE NAME",
"cost": 0.0037,
"balance": 9.9963
}
}| 필드 | 의미 |
|---|---|
| number | 조회 요청한 전화번호입니다. |
| name | 조회 가능한 이름 또는 대체 텍스트입니다. 신원 확인을 의미하지 않습니다. |
| cost | 이 처리 경로에서 보고하는, 계정 또는 서비스에 설정된 조회 요금입니다. 예시 값이 아닌 계정의 현재 요금을 사용하세요. |
| balance | 응답용으로 계산된 잔액입니다. 트랜잭션 방식으로 계정 잔액을 새로 조회한 결과가 아닙니다. |
요금 부과 및 대조 확인
이름이 반환된 결과에는 계정에 설정된 CNAM 요금이 부과됩니다. 반복 조회나 캐시를 이용한 조회에도 추가 요금이 발생할 수 있으며, 멱등성 키는 제공되지 않습니다. 자동 조회를 활성화하기 전에 계정의 현재 요금을 확인하세요.
캐시된 이름이 비어 있을 때 발생하는 알려진 응답 제약이 있습니다. 해당 분기에서는 계정 잔액을 차감하지 않는데도 핸들러가 빈 이름, 영이 아닌 비용, 차감된 것으로 계산한 잔액과 함께 API 코드 200을 반환할 수 있습니다. 이 응답만으로 요금이 부과되었다고 판단하지 마세요. 계정 청구 기록 및 새로 수행한 잔액 조회 결과와 대조하고, 판단이 어려운 결과는 지원팀에 문의하세요.
현재 선불 잔액 검사에서는 설정된 조회당 요금과 관계없이 조회 전에 최소 0.004의 잔액을 요구합니다. 구매가 비활성화된 계정도 거부됩니다. 이러한 검사가 있다고 해서 이 엔드포인트가 요금 견적이나 지출 한도를 위한 API가 되는 것은 아닙니다.
오류 및 재시도
HTTP 상태와 JSON의 status.code/status.msg를 모두 확인하세요. API 코드 403은 선불 잔액 부족, 구매 금지, 계정 권한 문제 또는 발신자 이름을 찾지 못했음을 의미할 수 있습니다. 이름을 찾지 못한 처리 경로에서는 코드가 문자열로 반환될 수 있습니다. 모든 403을 잘못된 인증 정보로 간주하지 말고 메시지를 확인하세요. 설정이 충돌하면 API 코드 500이 반환될 수 있습니다.
요금이 부과되는 조회가 수행된 후에 시간 초과가 발생할 수 있습니다. 애플리케이션에 적합한 경우에만 횟수를 제한하고 대기 시간을 늘려 가며 재시도하되, 먼저 결과가 불확실한 시도를 대조 확인하세요. 거부된 번호나 계정 권한 또는 잔액 문제로 실패한 요청을 반복해서 재시도하지 마세요. 계약 조건과 정확도 요구 사항이 허용하는 범위에서 자체 애플리케이션에 응답 캐시를 두면 반복 요청을 줄일 수 있습니다.
기타 전화번호 작업
이 읽기 작업은 발신 시 표시되는 이름/LIDB 업데이트, 전화번호부 등재 또는 발신자 등록과 별개입니다. 각 작업에는 별도의 필수 필드, 권한 및 요금이 있습니다. 번호 할당 범위로 번호 접두부 테이블을 확인하거나 전화번호 검색으로 주문 가능한 번호 재고를 확인하세요. 어느 작업도 발신자가 자신이 주장하는 본인임을 입증하지 않습니다.