계정 및 프로젝트 접근
허용된 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/status"이 엔드포인트는 요청 본문, 페이지 나누기 또는 날짜 필터를 읽지 않습니다.
응답
가상의 응답 예시입니다.
{
"status": {
"code": 200,
"msg": "Project Status"
},
"response": {
"uniqueid": "PROJECT_EXAMPLE",
"status": 2,
"status_str": "Completed",
"counts": {
"total": 2,
"pending": 0,
"in_progress": 0,
"completed": 1,
"rejected": 1
}
}
}바깥쪽의 status.code는 API 처리 결과를 나타냅니다. 이와 별개인 response.status는 프로젝트의 번호이동 상태에서 도출한 요약입니다. 두 항목을 혼동하지 마세요.
요약은 모든 번호의 결과를 나타내지 않습니다
요약은 해당 상태인 번호가 하나라도 있으면 In Progress를 선택합니다. 해당하는 번호가 없으면 Pending, Completed, Rejected 순서로 해당 번호가 있는 첫 번째 상태를 선택합니다. 일치하는 알려진 상태가 없으면 기본값인 Pending을 사용합니다. 따라서 완료된 번호와 거절된 번호가 함께 있는 프로젝트는 거절된 번호가 남아 있어도 Completed로 표시됩니다.
프로젝트 전체가 끝났다고 판단하기 전에 항상 건수와 개별 번호 목록을 확인하세요. counts.total에는 프로젝트의 모든 번호 행이 포함됩니다. 다른 카운터는 알려진 네 가지 상태 값만 집계하므로, 다른 값이 있으면 이 카운터들의 합이 전체 건수와 일치하지 않을 수 있습니다. 번호가 하나도 없는 프로젝트에서는 모든 카운터가 영으로, 요약이 Pending으로 표시됩니다.
번호이동 상태 해석
| 값 | 레이블 |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
상태의 숫자 값을 유지하고 알 수 없는 값도 처리할 수 있도록 하세요. 알 수 없는 레이블에는 새 레이블이 반드시 제공되는 것이 아니라 저장된 값이 대신 사용됩니다. 완료 상태나 예정일이 저장되어 있다는 사실만으로 수신 라우팅이나 해당 번호의 모든 서비스가 테스트되었다고 볼 수는 없습니다.
오류 및 제한 사항
HTTP 응답과 status.code/status.msg를 모두 확인하세요. 프로젝트가 존재하지 않거나 삭제되었거나 해당 계정에 속하지 않으면, 프로젝트를 찾을 수 없다는 메시지와 함께 API 코드 404가 반환됩니다. 인증 및 출발지 IP 제한도 적용됩니다. 예시는 실제 요청을 보내지 않으며, 성공 응답이 반환되어도 통신사가 번호이동을 접수하거나 완료했다는 증거는 아닙니다.
실행에 따른 영향
이 엔드포인트는 저장된 프로젝트 건수를 읽습니다. 검토된 핸들러에서는 번호이동을 신청하거나, 상태를 변경하거나, 통화를 시작하거나, 계정 잔액을 차감하지 않습니다. 통신사에 대한 실시간 폴링이나 웹훅 구독 기능도 제공하지 않습니다.