전화번호의 전화번호부 등재 신청

통신사에 전화번호부 등재 신청

MultiTEL에서 소유한 지원 대상 전화번호에 대해 전화번호부에 등재할 이름과 주소를 제출합니다. 이는 통신사의 유료 업데이트이며, 발신자 이름 조회나 개인 주소록 등록 또는 포털의 번호 인벤토리에 있는 LIDB 필드의 일반적인 업데이트가 아닙니다.

고객이 전화번호부 등재를 승인한 정보만 제출하세요. 이 기존 경로를 사용하기 전에 해당 번호에 대한 통신사 지원 여부를 확인하세요. 검토한 처리기는 공급자의 지원 자격이나 국제 전화번호 형식을 검증하지 않습니다. 통신사 요청에서는 북미 번호를 전제로 하며 저장된 번호의 첫 번째 숫자를 제거합니다.

계정 및 번호 요구 사항

허용된 출발지 IP 주소에서 활성화된 API 계정으로 HTTPS를 통해 접속하세요. 지정하는 번호는 해당 계정에 속하며 무효 처리되지 않은 구매 번호 레코드와 정확히 일치해야 합니다. 지원되는 북미 번호의 국가 코드 1 형식처럼, 인벤토리에 있는 국제 형식의 전체 숫자를 사용하세요. 요금제 ID, 번호 UUID 또는 다른 계정에 속한 번호를 사용하지 마세요.

폼 POST 요청

다음 항목 NUMBER에 소유한 번호를 설정하세요. 가상의 예시를 등재가 승인된 정보로 바꾸세요. 이 경로는 POST의 폼 필드를 읽으며, application/json 본문을 파싱하지 않습니다.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode "lastname=EXAMPLE" \
  --data-urlencode "firstname=EXAMPLE" \
  --data-urlencode "streetnum=1" \
  --data-urlencode "streetname=Example" \
  --data-urlencode "streetpredir=N" \
  --data-urlencode "streetpostdir=W" \
  --data-urlencode "city=Example City" \
  --data-urlencode "state=NY" \
  --data-urlencode "postalcode=10001" \
  "https://api.multitel.net/v3/directory/$NUMBER"

예시의 방위와 주소는 임시 값이며 권장 우편 주소가 아닙니다. 실제 고객 데이터에 가상의 방위를 추가하지 마세요. API의 필수 필드 검사는 기초적인 수준으로, 주소가 유효하거나 통신사에서 허용하는 주소임을 확인해 주지 않습니다. 또한 기존 웹사이트에는 다른 폼 요구 사항이 적용되었습니다.

이 구현은 선택 사항인 방위 요소가 없거나 비어 있으면 배열 키 누락 경고를 출력할 수 있습니다. 응답 형식이 잘못되었거나 통신사가 주소를 거부하면, 추측으로 주소를 수정해 반복 제출하지 말고 요청 참조 정보를 보관한 뒤 지원팀에 등재 내역 확인을 요청하세요.

과금 및 재시도 동작

검토한 처리기는 잔액이 최소 잔액 단위 기준 10.00인지 확인한 후 통신사에 접속합니다. 통신사와 로컬 번호 업데이트가 모두 성공을 보고하면, 다음 금액 10.00을 계정 잔액에서 차감하고 전화번호부 등재 설정 거래를 기록합니다. 이는 현재 구현된 금액이며 새 요금 제안이 아닙니다. 제출하기 전에 계정 약관에서 적용되는 청구 통화와 지원 서비스를 확인하세요.

이 작업에는 멱등성 키나 중복 주문 방지 기능이 없으며, 통신사 제출·로컬 업데이트·과금을 하나로 묶는 트랜잭션도 없습니다. 반복 요청이 성공하면 통신사에 다시 제출되고 요금이 다시 부과될 수 있습니다. 시간 초과나 API 오류가 발생했다고 해서 통신사가 이전 요청을 거부했다고 단정할 수는 없습니다. 로컬 업데이트가 실패하기 전에 공급자가 이미 요청을 수락했을 수 있습니다.

응답

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": ""
}

일반적인 성공 응답에서 빈 문자열로 설정되는 필드는 response이며, 등재 ID나 완료 세부 정보는 반환되지 않습니다. 이는 통신사 및 로컬 업데이트 처리 경로가 성공을 보고했다는 뜻입니다. 모든 외부 전화번호부에 게시되었거나 즉시 반영되었음을 증명하지 않으며, 향후 발신자 ID 표시도 보장하지 않습니다.

기존 오류

HTTP 상태와 함께 JSON의 다음 항목도 확인하세요: status.code/status.msg. 인증 및 출발지 IP 제한으로 인해 사용할 수 있는 응답을 받지 못할 수도 있습니다. 기존 처리기에 명시적인 HTTP 메서드 제한이 없다는 이유로 GET이나 쿼리 매개변수를 사용해 업데이트를 요청하지 마세요.

재시도 전 확인

1. 요청을 보내기 전에 소유한 번호, 통신사 지원 대상 여부, 등재가 승인된 정보 및 요금을 확인하세요.
2. 한 번만 제출하고, 고객 주소가 공개 로그나 분석 데이터에 노출되지 않도록 하면서 계정 측 결과를 보관하세요.
3. 공식적으로 지원되는 계정 처리 절차나 지원팀을 통해 저장된 등재 정보와 거래 내역을 확인하세요. 통신사가 확인한 처리 시간만큼 기다리세요. 이 API는 반영 기한을 보장하지 않습니다.
4. 결과가 불확실하면 재시도 전에 지원팀에 통신사 주문과 로컬 과금 내역의 대조를 요청하세요. 요청을 반복하는 것은 멱등성이 있는 상태 확인이 아닙니다.