브랜드의 심사 결과 확인하기

확인할 브랜드 선택하기

본인 계정의 브랜드 ID를 사용하세요. 한 사업자의 심사를 다른 사업자의 심사로 혼동하지 않도록 조회된 심사 기록과 브랜드 ID를 함께 보관하세요. 다른 계정의 식별자는 사용하지 마세요.

기존 심사 추적하기

다음 항목이 있으면 보관하세요: vettingId, evpId, vettingClass 및 vettingStatus. 현재 동기화 처리에서는 PENDING 및 UNSCORE를 추가 확인이 필요한 결과로 처리하고, ACTIVE 및 FAILED를 정산을 위한 최종 결과로 처리합니다. 후속 조치가 필요한지 판단하기 전에 반환된 세부 정보를 확인하세요. 목록이 비어 있다는 사실만으로 이전 제출이 레지스트리에 도달하지 않았다고 입증되지는 않습니다.

이전 주문의 요금 이해하기

상태를 확인해도 다른 심사가 주문되지는 않습니다. 다만 완료된 결과를 대조하여 이전의 유료 심사 요청에 연결된 요금을 정산할 수 있습니다. 여기에는 해당되는 심사 실패 요금도 포함됩니다. 주문 당시 확인한 가격과 약관을 적용하세요. 과거 예시나 상태 응답을 근거로 현재 가격을 추정하지 마세요.

다시 주문하지 않고 조회 재시도하기

일시적인 장애가 발생하면 브랜드 ID와 알고 있는 심사 ID를 보관하고, Retry-After를 준수하며 백오프를 적용해 이 조회를 재시도하세요. 상태 조회가 실패했거나 예상치 못한 본문이 반환되었다는 이유만으로 새 심사를 주문하지 마세요. 불일치가 계속되면 인증된 지원 채널을 통해 관련 참조 ID와 함께 MultiTEL에 문의하세요.

등록 단계를 구분하기

심사를 통해 브랜드의 심사 결과가 확정됩니다. 캠페인 자격 확인, 캠페인 등록 및 번호 할당은 각각 별도의 단계입니다. 메시지를 보내기 전에 각 단계의 현재 상태와 요건을 확인하세요.

요청

허용된 원본 IP 주소에서 HTTPS를 통해 활성화된 API 계정을 사용하세요. 레지스트리 인증 정보가 아닌 본인 계정의 인증 정보를 사용하세요. 브랜드는 인증된 계정에 연결되어 있어야 합니다.

경로에 브랜드 ID를 넣고 필수 vettingStatus 쿼리 필터를 지정하여 GET 요청을 보냅니다. 검토된 스키마는 상태 배열을 정의하며, 이 예시에서는 ACTIVE 값 하나를 지정하여 요청합니다. 이 가이드에서는 여러 값의 인코딩 방식이나 제공업체가 필터 없는 요청을 수락하는지 여부를 확인하지 않았습니다. 요청 본문은 필요하지 않습니다.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting?vettingStatus=ACTIVE"

경로 매개변수
이름	유형	필수 여부	설명
`brandId`	문자열	예	본인의 MultiTEL 계정에 연결된 레지스트리 브랜드 ID입니다. 계정 ID나 심사 ID가 아닙니다.

쿼리 매개변수
이름	유형	필수 여부	설명
`vettingStatus`	문자열 배열	예	필수 상태 필터입니다. 허용되는 값: PENDING, UNSCORE, ACTIVE, FAILED, EXPIRED. 이 예시에서는 ACTIVE 값 하나를 지정합니다. 여러 값의 인코딩 방식이나 제공업체가 필터 없는 요청을 수락한다는 점을 보장하지는 않습니다.

응답

현재 라우트는 기존 v3 응답 래퍼를 사용하는 대신 레지스트리의 HTTP 상태와 본문을 그대로 유지합니다. 축약된 가상 배열은 로컬 동기화 경로에서 사용하는 필드를 보여 줍니다. 실제로 수집한 레지스트리 응답이 아니며, 완전한 스키마를 보장하지도 않습니다. 기록을 읽기 전에 HTTP 상태와 JSON을 확인하세요. 각 vettingId를 선택한 브랜드와 함께 보관하세요.

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

[
  {
    "vettingId": "example-vetting-id",
    "evpId": "example-review-provider",
    "vettingClass": "STANDARD",
    "vettingStatus": "ACTIVE"
  }
]

오류

401: 계정 인증에 실패했습니다. 인증 정보, API 활성화 상태 및 적용되는 원본 IP 제한을 확인하세요.
404: 브랜드가 이 계정에 연결되어 있지 않거나 레지스트리에서 브랜드를 찾을 수 없습니다. 계정 소유 관계에 따른 거부는 레지스트리 요청 전에 발생합니다.
429: 계정 또는 레지스트리 요청 한도에 도달했습니다. Retry-After를 준수하고 백오프를 적용하세요.
502/503: 전송, 레지스트리, 요청 제한기 또는 로컬 처리를 이용할 수 없습니다. 오류가 발생했다는 사실만으로 이전 심사 요청이 실패했다고 확정할 수는 없습니다.

가용성 및 부수 효과

이 GET 요청은 새 심사를 주문하지 않습니다. 레지스트리 결과를 가져오고, 요청 감사 기록을 작성하며, 저장된 결과를 동기화합니다.
완료된 결과를 조회하면 이전에 접수된 유료 심사 주문의 요금이 정산될 수 있습니다. 심사가 실패한 경우에도 해당되는 실패 요금이 부과될 수 있습니다. 주문할 때 가격과 약관을 확인하세요. 이 조회는 가격 견적이 아닙니다.
이 GET 요청으로 새로 발견되어 가져온 기록은 새로운 유료 주문으로 자동 분류되지 않습니다.
심사 결과가 성공 또는 ACTIVE라고 해서 캠페인 승인, 전화번호 할당 또는 메시지 전송 권한을 의미하는 것은 아닙니다.