조회 방식 선택
| 등급 | 쿼리당 공개 요금 | 동작 |
|---|---|---|
| Starter | US$0.0026 | 자체 보유 정보와 캐시된 발신자 이름 정보를 사용합니다. |
| Standard | US$0.0037 | 각 쿼리마다 실시간 네트워크 조회를 수행합니다. |
| Mixed | US$0.004 | 먼저 실시간 조회를 시도하고, 이름을 찾지 못하면 Starter 데이터로 대체합니다. |
조회 방식은 선택한 서비스에 따라 결정되며, Mixed는 캐시 우선 조회가 아닙니다. 운영 환경에서 사용하기 전에 계정에 적용된 요금을 확인하세요. 발신자 이름은 신원이나 소유권의 증거가 아닙니다.
인증된 조회 보내기
엔드포인트: GET https://api.multitel.net/v3/cnam/NUMBER. 국가 코드를 포함한 국제 형식의 숫자만 사용하고, 구두점이나 앞에 붙는 더하기 기호(+)는 넣지 마세요. 승인된 API 자격 증명을 사용하여 애플리케이션 서버에서 실행하세요.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/cnam/12025550123"두 환경 변수는 서버 측 시크릿 구성을 통해 제공하세요. 프로비저닝된 베어러 자격 증명은 해당 액세스가 활성화되어 있고 소스 IP 제한을 충족하는 경우에만 대안으로 사용할 수 있습니다. API 시크릿을 공개 브라우저 번들에 절대 포함하지 마세요.
JSON 응답 읽기
이 응답은 설명용 예시입니다. 반환되는 이름과 요금은 조회 내용과 선택한 서비스에 따라 달라집니다.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"name": "EXAMPLE CALLER",
"cost": "0.004",
"balance": "24.9960"
}
}status.code- 애플리케이션 결과 코드입니다. 200과 비교하기 전에 문자열/숫자 값을 정규화하세요.
status.msg- 함께 제공되는 결과 또는 거부 메시지입니다.
response.number- 조회한 번호입니다.
response.name- 제공되는 발신자 이름입니다.
response.cost- 이 쿼리에 대해 보고된 요금입니다. 십진수 금액으로 처리하세요.
response.balance- 보고된 계정 잔액입니다(있는 경우).
이름 없음 결과 및 오류
요청이 성공했다고 해서 유용한 발신자 이름이 반환된다는 보장은 없습니다. 이름이 비어 있는 경우, 이름 대신 번호가 반환된 경우, 조회가 거부된 경우를 처리하세요. 애플리케이션 코드 403은 크레딧 부족, 금지된 구매 또는 결과가 없는 번호를 나타낼 수 있으므로 메시지를 확인하세요.
response.name에 접근하기 전에 HTTP 상태와 JSON status를 모두 확인하세요. 오류 시에는 응답 객체가 없을 수 있습니다. 이름이 없더라도 일반 통화의 라우팅을 막아서는 안 됩니다.
청구, 재시도 및 발신자 ID 업데이트와의 차이
새로운 조회에는 쿼리 요금이 발생할 수 있습니다. 이러한 조회 인터페이스는 멱등성 키(idempotency key)를 문서화하지 않으므로, 새로 재시도하면 청구 대상 쿼리가 한 번 더 발생할 수 있습니다. 전송/서비스 장애에는 제한된 백오프를 사용하고, 계정 오류를 먼저 해결하며, 보고된 쿼리 요금을 대조하세요. 캐시는 애플리케이션에 적합한 기간 동안만 사용하세요. 발신자 이름 데이터는 변경될 수 있습니다.
CNAM 조회는 이름을 읽기만 합니다. 발신 통화에 표시되는 이름은 변경되지 않습니다. LIDB 발신자 이름 업데이트는 고유한 필드, 승인, 요금 및 처리 절차를 갖는 별도의 작업입니다.