번호이동 프로젝트 조회

계정 및 프로젝트 접근

허용된 IP 주소에서 활성화된 API 계정을 사용하여 HTTPS로 접근하세요. 프로젝트는 해당 계정에 속해야 하며 삭제된 상태여서는 안 됩니다. 숫자형 데이터베이스 ID나 전화번호가 아니라 번호이동 주문 워크플로에서 얻은 프로젝트의 고유 ID를 사용하세요. 요청을 구성할 때 프로젝트 ID를 URL 인코딩하세요.

요청

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID"

이 응답을 기밀 정보로 취급하세요

전체 응답에는 기존 통신사의 청구 정보가 포함됩니다. 여기에는 저장된 billing_pin, 청구 계정, 전화번호, 주소, 회사 및 권한이 있는 연락 담당자의 세부 정보가 포함됩니다. API는 이러한 필드를 마스킹하지 않습니다. 워크플로에 상태나 전화번호 목록만 필요하다면 해당 정보만 요청하세요. 전체 상세 응답이 브라우저 저장소, 분석 시스템, 공개 로그 및 고객 지원용 스크린샷에 포함되지 않도록 하고, 권한이 있는 고객에게 필요한 필드만 표시하세요.

응답 구조

일부 필드만 선택한 가상의 예시이며, 추가 필드가 반환될 수 있습니다.

{
  "status": {
    "code": 200,
    "msg": "Project Detail"
  },
  "response": {
    "project": {
      "id": 11,
      "uniqueid": "PROJECT_EXAMPLE",
      "project_name": "Example transfer",
      "location": "US",
      "status": 0,
      "status_str": "Pending"
    },
    "counts": {
      "total": 0,
      "pending": 0,
      "in_progress": 0,
      "completed": 0,
      "rejected": 0
    },
    "numbers": [],
    "events": [],
    "uploads": []
  }
}

이 예시는 의도적으로 일부만 보여 주며 모든 청구 관련 인증 정보와 개인 연락처 값을 생략합니다. 예시에서 생략했다고 해서 실제 응답에서도 해당 정보가 가려지는 것은 아닙니다.

프로젝트 상세 섹션
섹션	내용
project	숫자형 행 ID, 고유 프로젝트 ID, 프로젝트 이름, 위치, 저장된 청구·연락처·주소 데이터, 생성 시각 및 산출된 상태입니다. 기존 통신사를 나타내는 레거시 필드의 철자는 loosing_carrier입니다.
counts	전체 전화번호 행 수와 Pending, In Progress, Completed, Rejected 각각의 개수입니다.
numbers	프로젝트 전화번호 목록 엔드포인트와 동일한 필드 구성의 전화번호 데이터이며, 고객 의견과 저장된 일정 값이 포함됩니다.
events	저장된 이벤트 행과 원본 및 파싱된 페이로드 필드입니다. 이벤트 엔드포인트의 공개 범위 및 형식 제한이 적용됩니다.
uploads	문서 메타데이터로, 숫자형 ID, upload_type, file_name, file_extension, date_created 및 상대 URL인 download_url이 포함됩니다. 이 URL에 접근할 때도 계정 인증이 필요합니다.

요약 및 메타데이터 해석

산출되는 상태의 우선순위는 In Progress, Pending, Completed, Rejected 순이며, 해당하는 상태가 없으면 Pending을 사용합니다. 요약 상태가 Completed여도 거절된 전화번호가 함께 존재할 수 있습니다. 모든 전화번호의 이동이 완료되었다고 가정하지 말고 개수와 각 전화번호의 상태를 확인하세요.

응답에는 문서 메타데이터가 포함되며 파일 자체의 바이트는 포함되지 않습니다. 페이지 나누기나 증분 조회용 커서는 없습니다. 상세 쿼리와 목록 쿼리는 별도의 읽기 작업이며, 트랜잭션 일관성이 보장되는 단일 스냅샷이 아닙니다. 날짜는 저장된 값 그대로 유지되며 시간대 변환은 문서화되어 있지 않습니다. 프로젝트 경로에는 uniqueid를 사용하세요. 숫자형 프로젝트 ID로 대체할 수 없습니다.

오류 및 제한

HTTP 응답과 다음 두 필드를 모두 확인하세요: status.code/status.msg. 프로젝트가 존재하지 않거나 삭제되었거나 해당 계정에 속하지 않으면, 프로젝트를 찾을 수 없다는 메시지와 함께 API 코드 404가 반환됩니다. 인증 및 출발지 IP 제한도 적용됩니다. 예시는 실제 요청을 실행하지 않으며, 성공 응답이 통신사의 번호이동 접수 또는 완료를 증명하지는 않습니다.

처리 영향 및 워크플로

현재 포털의 번호이동 주문 화면에서 사용하는 공식 상세 조회 경로입니다. 포털은 사용자 인터페이스에 맞게 필드를 매핑하고 자체적인 고객용 필드 구성을 적용합니다. 원본 API 응답이 포털의 JSON 또는 표시 내용과 동일하다고 가정하지 마세요. 검토된 상세 조회 핸들러는 프로젝트를 변경하지 않으며 통신사 요청이나 과금을 직접 시작하지도 않습니다.