증빙 서류 범주 목록 조회

증빙 서류 범주 선택

신원 정보에 필요한 증빙 서류를 준비할 때 반환된 범주와 주체 유형을 사용하세요. 이 목록은 범주를 설명하며, 업로드한 파일 목록이 아니고 어떤 증빙 서류의 승인도 의미하지 않습니다.

실제 요건 충족

범주가 목록에 있다고 해서 모든 국가, 번호 유형 또는 고객 신원 정보에 대한 요건을 충족하는 것은 아닙니다. 증빙 서류를 업로드하기 전에 적용되는 요건을 읽고, 반환된 ID의 내부 구조나 의미를 해석하지 말고 그대로 사용하세요.

요청

활성화된 API 계정의 인증 정보를 사용하여 HTTPS로 접속하세요. 기본 인증과 활성화된 API 계정의 베어러 토큰이 지원되며, 계정 제한이 적용됩니다.

문서에 명시된 매개변수를 사용하는 경우 URL 경로에 포함하여 GET 요청을 보내세요.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_proof_types"

응답

HTTP 상태뿐 아니라 JSON 본문의 status.code도 확인하세요. response는 id, name, entity_type를 포함하는 객체의 배열입니다. 이 값들은 현재 증빙 서류 카탈로그에서 가져옵니다. ID는 내부 구조나 의미를 해석하지 않고 사용해야 하므로, 직접 구성하거나 해시로 생성하지 말고 반환된 값을 복사하세요. 빈 카탈로그도 정상 응답으로 반환될 수 있습니다. 이 예시가 주체 유형의 모든 열거 값을 포함한다고 가정하여 하드코딩하지 마세요.

응답 구조를 보여 주는 예시이며, 실제 계정 데이터나 현재 견적이 아닙니다.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "PROOF_TYPE_ID_FROM_RESPONSE",
      "name": "Example proof category",
      "entity_type": "ENTITY_TYPE_FROM_RESPONSE"
    }
  ]
}

오류

인증 또는 서비스 오류는 status.code와 status.msg를 확인하세요. 빈 카탈로그가 정상적으로 반환되어도 서류 승인이나 등록 면제를 의미하지 않습니다.

이용 가능 여부 및 부수 효과

이 카탈로그 및 요건 조회는 신원 정보를 생성하거나, 증빙 서류를 업로드하거나, 번호를 등록하거나, 주문을 접수하지 않습니다.
카탈로그 응답이 성공했다고 해서 고객의 서류가 승인되었거나 선택한 번호를 활성화할 수 있음이 확인된 것은 아닙니다.