라우팅 정보 조회

북미 전화번호의 라우팅 정보를 요청합니다. 제공되는 라우팅 및 통신사 데이터를 해석하는 데 사용하세요. 가입자 신원, 번호 소유권, 연결 가능 여부 또는 구매 가능 여부를 입증하는 용도로 사용하지 마세요. 조회 시 계정에 요금이 부과될 수 있습니다.

요청

활성화된 API 계정과 해당 계정에서 허용하는 출발지 IP 주소를 사용하세요. 국가 코드 1을 포함한 전체 번호를 숫자로만 입력하세요. 이 예제는 환경 변수와 가상의 번호를 사용합니다. 처리기는 문장 부호나 구분 기호를 정규화하지 않으므로 제출하기 전에 입력값을 검증하세요.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/lrn/12025550123

응답

설명을 위해 일부 필드만 제시한 예시입니다. 제공되는 필드는 데이터 출처와 번호 유형에 따라 달라집니다.

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

표준 조회는 반환되는 필드 이름을 소문자로 변환합니다. 데이터 출처에 따라 통신사, 요금 구역, 위치 및 관할 구역 필드가 포함될 수 있습니다. 응답은 고정된 형식의 완전한 가입자 기록이 아닙니다. local 플래그는 숫자 1 또는 문자열 0일 수 있습니다. 처리기는 반환된 라우팅 번호와 입력한 전화번호를 비교하여 ported 값을 계산합니다. 이 값을 검증된 전체 번호 이동 이력으로 해석하지 마세요.

요금 및 재시도

검토한 처리기는 완료 처리 경로에 도달하여 조회를 기록할 때 계정에서 $0.00025를 차감합니다. 반환되는 비용은 일반적으로 숫자만으로 된 금액이 아니라 달러 기호가 포함된 문자열입니다. 멱등성 키는 제공되지 않습니다. 요청을 반복하면 추가 요금이 발생할 수 있습니다.

선불 계정의 경우 코드는 잔액이 0.00025 이상인지 확인합니다. 현재 잔액 부족 메시지에는 $5가 표시되지만, 이는 실제 기준 금액과 일치하지 않습니다. 이 실패를 잔액 부족으로 인한 거부로 해석하고, 재시도하기 전에 계정 잔액을 확인하세요.

실패 및 불완전한 성공

HTTP 상태와 JSON의 status.code/status.msg를 모두 확인하세요. 표준 조회 결과가 비어 있으면 API 코드 404가 반환됩니다. API 코드 403은 선불 잔액 부족을 나타낼 수 있습니다.

현재 수신자 부담 번호의 오류 처리 경로에서는 유용한 라우팅 필드가 없어도 조회 요금이 차감되고 API 코드 200이 반환될 수 있습니다. 이때 비용 정보가 불완전할 수도 있습니다. 따라서 코드 200만으로는 사용 가능한 조회 결과를 얻었다고 판단할 수 없습니다. 애플리케이션에 필요한 필드를 검증하고, 불명확한 요금은 계정 청구 기록과 대조하세요. 결과가 불완전하면 지원팀에 문의하세요.

검토한 구현에서는 입력 길이에 따라 수신자 부담 번호의 처리 방식이 달라집니다. 국가 코드를 포함한 전체 국제 전화번호를 숫자로만 입력하는 것이 좋습니다. 필요한 수신자 부담 번호 지원 범위는 지원팀에 확인하세요. 형식이 잘못되었거나 불완전한 결과에 대해서는 자동으로 재시도하지 마세요. 또한 해당 번호로 전화하는 것이 안전하거나 허용된다고 판단하는 근거로 라우팅 조회에 의존하지 마세요.