계정 및 프로젝트 접근
허용된 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/numbers"응답
가상의 응답 예시입니다.
{
"status": {
"code": 200,
"msg": "Project Numbers",
"results": 1
},
"response": [
{
"id": 21,
"number": "12025550123",
"status": 0,
"status_str": "Pending",
"isocode": "US",
"updated": "2026-10-23 12:00:00",
"foc": "",
"comment": "Example customer-visible note",
"date_created": "2026-10-23 12:00:00",
"date_completed": ""
}
]
}response 항목은 목록입니다. 번호가 없는 기존 프로젝트는 API 코드 200 및 status.results 값 0과 함께 빈 목록을 반환합니다. 반면 존재하지 않는 프로젝트는 API 코드 404를 반환합니다.
번호 필드
| 필드 | 의미 |
|---|---|
| id, number, isocode | 숫자 행 ID, 저장된 전화번호 텍스트 및 국가 코드입니다. 행 ID는 프로젝트 ID가 아닙니다. |
| status, status_str | 숫자 상태 및 알려진 해당 레이블입니다. |
| foc | 저장된 최종 주문 확약 일정 값입니다. 비어 있을 수 있으며, 핸들러는 이를 문서화된 시간대나 타임스탬프 형식으로 변환하지 않습니다. |
| updated, date_created, date_completed | 저장된 갱신, 생성 및 완료 값입니다. 빈 값을 명시적으로 처리하세요. ISO8601 형식이라고 가정하거나 가상 예시에서 시간대를 추론하지 마세요. |
| comment | 저장된 고객용 의견입니다. 실행 가능한 HTML이 아닌 텍스트로 표시하세요. |
이 반환 구조에서는 직원 전용 internal_comment 필드를 제외합니다. 별도의 레거시 단일 번호 조회도 같은 반환 구조를 사용한다는 뜻은 아닙니다.
정렬 및 모니터링
쿼리는 생성 시간의 오름차순으로 정렬합니다. 생성 시간이 같은 행에 대해서는 추가 정렬 순서가 보장되지 않습니다. 페이지 구분, 증분 커서 또는 날짜 필터가 없습니다. 프로젝트를 대조하려면 전체 목록을 읽고, 현재 행 수를 영구적인 카탈로그로 간주하지 마세요.
번호 이동 상태 해석
| 값 | 레이블 |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
숫자 상태를 유지하고 알 수 없는 값도 처리하세요. 레이블이 알 수 없는 경우 새 레이블이 보장되는 것이 아니라 저장된 값으로 대체됩니다. 저장된 완료 상태나 예정 날짜만으로 인바운드 라우팅 또는 해당 번호의 모든 서비스를 테스트한 것은 아닙니다.
오류 및 제한
HTTP 응답 및 status.code/status.msg 항목을 모두 확인하세요. 없거나 삭제되었거나 해당 계정 소유가 아닌 프로젝트는 프로젝트를 찾을 수 없다는 메시지와 함께 API 코드 404를 반환합니다. 인증 및 소스 IP 제한도 적용됩니다. 예시는 실제 요청을 보내지 않으며, 성공 응답이 통신 사업자의 이전 수락 또는 완료를 입증하지는 않습니다.
영향
검토한 핸들러는 프로젝트와 저장된 번호 행을 읽기만 합니다. 응답은 스냅샷이며 통신 사업자의 확인이나 실시간 서비스 테스트가 아닙니다. 번호 이동을 시작하거나 라우팅을 변경하거나 계정에서 금액을 차감하지 않습니다.