계정 소유의 메시징 브랜드 사용
허용된 출발지 IP에서 활성화된 API 계정으로 HTTPS를 통해 접속하세요. Basic 및 Bearer 인증을 지원합니다. 브랜드 ID는 해당 계정에 속해야 합니다. 제공업체 토큰, 브랜드 식별 정보, 반환된 보고서는 비공개로 관리하세요.
새 외부 심사 신청
심사 제공업체에 이 브랜드의 새 심사를 요청하려면 POST를 사용하세요. 이미 제공업체의 결과가 있다면 대신 가져오기를 사용하세요. 이 작업은 브랜드 식별 정보 재확인과는 별개입니다.
먼저 현재 브랜드 정보를 조회하고 식별 정보를 확인하세요. 최신 카탈로그에서 지원되는 제공업체와 심사 등급을 선택하고 해당 제공업체의 요건을 확인하세요. 모든 제공업체가 모든 등급을 지원하는 것은 아닙니다. 정치 관련 심사의 추가 세부 정보에는 예시 데이터가 아닌 실제 조직이나 캠페인에 관한 내용을 기재해야 합니다.
제공업체에 보낼 요청 준비
| 필드 | 값 |
|---|---|
| evpId | 최신 외부 심사 제공업체 카탈로그에 있는 제공업체 ID로, 필수 항목이며 길이는 1–10자입니다. |
| vettingClass | 구매하려는 심사 등급으로, 지원되는 등급을 명시적으로 선택하고 가격을 확인하세요. |
| additionalRequestPayload | 제공업체별 세부 정보를 담은 JSON 인코딩 문자열로, 정치 관련 심사에 필수입니다. 중첩 객체가 아니라 외부 JSON 객체 안에 들어가는 문자열입니다. 필요한 모든 세부 정보는 선택한 제공업체에 확인하세요. |
성공 및 실패 시 요금 확인
십월 24일(2026년)에 확인한 미국 달러 기준 현행 소매 요금입니다. 실제로 신청하기 전에 최신 금액을 확인하세요. 선불 잔액은 성공 시 요금을 기준으로 확인하며, 구매가 활성화되어 있어야 합니다.
| 심사 등급 | 활성 결과 | 실패 결과 |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL(Express 요청 포함) | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
대기 중인 신청에는 성공 및 실패 시 금액이 유지되며, ACTIVE 또는 FAILED 결과가 동기화될 때 정산됩니다. 표의 마지막 두 등급은 어느 최종 결과에 대해서든 동일하게 설정된 요금을 적용합니다. 최종 결과가 즉시 나오는 경우 신청 응답 처리 중에 요금이 청구될 수 있습니다. 이후 상태 동기화를 통해 보류 중인 요금이 정산될 수도 있습니다.
mock:true를 외부 심사가 무료라는 보장으로 여기지 마세요. 현재 외부 심사 정산 처리 경로에서는 여전히 해당 신청이 기록되고 요금이 청구될 수 있습니다. 이 안내는 테스트를 위한 실제 구매를 요구하지 않습니다. 유료 심사를 승인할 의사가 생기기 전까지는 오프라인 테스트 데이터를 사용하세요.
내용을 검토한 신청 한 건 제출
제공업체 ID, 심사 등급, 필요한 추가 정보를 담은 vetting-order.json 파일을 준비하세요. 이 파일에는 실제로 보내려는 요청이 들어갑니다. 비공개로 관리하세요.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request POST \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-order.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"실제 결과 추적
성공한 HTTP 응답에도 대기 중인 심사 기록이 포함될 수 있습니다. 해당 vettingId를 보관하고, vettingStatus, 사유, 점수, 효력 발생일과 만료일을 제공되는 범위에서 확인하세요. PENDING과 UNSCORE는 추가 확인이 필요하며, ACTIVE, FAILED, EXPIRED는 서로 다른 결과를 나타냅니다. HTTP 요청이 수락되었다는 사실만으로 양호한 점수나 캠페인 이용 자격이 입증되는 것은 아닙니다.
기록을 추적하려면 외부 심사 상태를 사용하세요. 최종 결과를 조회하거나 가져오면 이전 유료 신청이 정산될 수 있습니다. 기존 미결제 요금이 청구되지 않는다고 보장할 수는 없습니다.
동일한 요청 재시도
수행하려는 작업마다 하나의 Idempotency-Key를 사용하고 메서드, 경로, 쿼리, 본문 바이트를 정확히 그대로 유지하세요. 키에는 공백 없이 출력 가능한 ASCII 문자 1–128자를 사용할 수 있습니다. 진행 중인 요청과 중복되면 Retry-After와 함께 409가 반환될 수 있습니다. 완료된 요청은 오류를 포함하여 저장된 응답을 그대로 다시 반환합니다. 요청 빈도 제한을 준수하세요.
전송 장애 후 캐시된 502가 반환될 수 있습니다. requestId가 포함된 캐시된 500은 레지스트리가 작업을 수락했지만 로컬 영구 저장이나 요금 청구에 실패했음을 의미할 수 있습니다. 새 키를 사용하기 전에 요청 ID를 보관하고 현재 기록을 확인한 뒤 지원팀과 대조하여 처리 내역을 정리하세요. 오류가 발생했다고 해서 신청이 존재하지 않는다고 단정하지 마세요.