등록 요건 읽기

국가와 번호 유형 선택

등록 국가를 선택한 다음, get_document_number_types 에서 반환된 이름을 사용하세요. 해당 이름을 number_type 값으로 전송하세요. 유형 ID나 일반적인 번호 검색 범주를 전송하지 마세요.

반환된 안내 읽기

관련 신원/문서 워크플로를 위해 요건 ID와 관계 ID를 보관하세요. 이 호출은 요건을 반환할 뿐이며 파일을 검증하거나 제출하지 않습니다. 반환된 안내와 선택한 번호에 특정한 모든 요건을 따르세요.

오류를 면제로 해석하지 마세요

유효하지 않은 국가 또는 국가 등록 문서 없음에 관한 오류는 두 가지 조건을 결합한 것입니다. 이는 등록이 불필요하다는 증거가 아닙니다. 조회 실패나 빈 결과 역시 고객이나 번호를 승인하는 것이 아닙니다. 결과가 불명확하면 지원팀에 문의하세요.

요청

활성화된 API 계정 자격 증명을 HTTPS를 통해 사용하세요. Basic 인증과 활성화된 API 계정 Bearer 토큰이 지원되며, 계정 제한이 적용됩니다.

POST 방식으로 application/json 또는 application/x-www-form-urlencoded 를 사용하여 전송합니다.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  --request POST \
  --header "Content-Type: application/json" \
  --data '{"country":"US","number_type":"Local"}' \
  "https://api.multitel.net/v3/get_requirements"

본문 매개변수
이름	유형	필수	설명
`country`	문자열	예	get_document_countries 에서 가져온 국가 ISO 코드입니다.
`number_type`	문자열	예	get_document_number_types 에서 가져온 유형 이름(예: Local)입니다. 대소문자는 구분하지 않습니다. ID가 아닌 이름을 제공하세요.

응답

HTTP 상태와 함께 JSON 본문의 status.code 도 확인하세요. response 는 id, type, attributes 를 포함하는 단일 요건 리소스이며, 반환되는 경우 relationships 도 포함됩니다. 리소스와 관계 데이터의 ID는 불투명한 값입니다. 선택적 restriction_message 텍스트는 HTML 태그가 제거되어 있습니다. 남은 텍스트는 신뢰할 수 있는 HTML이 아닌 텍스트로 처리하세요. 핸들러는 첫 번째 요건 리소스를 반환하므로 이 응답이 전체 목록이라고 추정하지 마세요. 속성/관계의 제공 여부는 국가와 유형에 따라 다르며, 예시는 완전한 고정 스키마가 아닙니다.

예시용 응답 형태이며, 실제 계정 데이터나 현재 견적이 아닙니다.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "id": "REQUIREMENT_ID_FROM_RESPONSE",
    "type": "RESOURCE_TYPE_FROM_RESPONSE",
    "attributes": {
      "restriction_message": "Example country-specific instructions."
    }
  }
}

오류

400: 국가와 number_type 검증 실패: 필수 값을 둘 다 제공하세요. 검증 텍스트에는 서식이 포함될 수 있습니다.
400: Invalid country ISO or No country registration documents required.: 이 모호한 메시지는 그 자체로 등록 면제를 증명하지 않습니다.
400: Invalid number type: 반환된 유형 이름을 사용하세요. 레거시 오류에는 Global, Local, Mobile, National, Shared Cost 및 Toll Free 가 나열됩니다.
500: Unable to load registration requirements for the specified country and number type.: 요건이 정상적으로 반환되지 않았습니다. 나중에 다시 시도하거나 지원팀에 문의하세요.

가용성 및 부작용

이 카탈로그/요건 조회는 신원을 생성하거나, 증빙을 업로드하거나, 번호를 등록하거나, 주문을 생성하지 않습니다.
카탈로그 응답이 성공했더라도 문서가 승인되었거나 선택한 번호를 활성화할 수 있다는 확인이 아닙니다.