계정 및 프로젝트 접근
허용된 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/events"응답
가상의 응답 예시입니다.
{
"status": {
"code": 200,
"msg": "Project Events",
"results": 1
},
"response": [
{
"id": 31,
"subject": "Example project update",
"event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
"type": "comment",
"value": "Example update",
"source": "Example source",
"date_created": "2026-10-23 12:00:00"
}
]
}이벤트가 없는 기존 프로젝트는 API 코드 200과 빈 목록을 반환하며, status.results 값은 0입니다. 결과는 생성 시각의 내림차순으로 요청됩니다. 생성 시각이 같은 항목에 대한 추가 정렬 기준, 페이지 나누기, 커서 또는 날짜 필터는 없습니다.
이벤트 페이로드를 주의 깊게 읽기
id는 이벤트 행의 숫자형 ID이고, subject는 저장된 제목이며, date_created는 저장된 날짜 및 시간 값입니다. 이 엔드포인트는 원시 event 문자열을 보존하며, 그 안의 type, value 및 source 항목의 디코딩도 시도합니다. 페이로드가 JSON 객체가 아니거나 속성이 누락된 경우, 해당 파싱 필드는 빈 문자열이 됩니다.
페이로드는 고정된 열거형이 아니며 일반 텍스트 스키마라는 보장도 없습니다. 출처 텍스트를 검증된 신원 정보로 취급하거나 이벤트 내용을 HTML로 렌더링하지 마세요. 원시 이벤트는 권한이 부여된 서버 측 워크플로에서만 다루고, 권한이 있는 사용자에게 적절한 텍스트만 표시하세요. 이 엔드포인트에는 직원과 고객의 이벤트 열람 범위를 구분하는 별도 필터나 내용 가림 기능이 없습니다.
이력은 전달을 보장하지 않습니다
이 데이터는 저장된 프로젝트 이력이며, 웹훅 스트림이나 변경 불가능한 동기화 커서 또는 모든 데이터베이스 변경 사항을 빠짐없이 담은 기록이 아닙니다. 예를 들어, 검토된 번호 추가 핸들러를 통해 번호를 추가해도 그 작업 자체로는 이벤트가 생성되지 않습니다. 이벤트를 읽는 것과 함께 번호 목록과 상태별 개수도 대조하세요.
오류 및 제한
HTTP 응답과 status.code/status.msg 값을 모두 확인하세요. 프로젝트가 존재하지 않거나 삭제되었거나 해당 계정의 소유가 아닌 경우, 프로젝트를 찾을 수 없다는 메시지와 함께 API 코드 404가 반환됩니다. 인증 및 출발지 IP 제한도 적용됩니다. 이 예시들은 실제 요청을 보내지 않으며, 성공 응답이 반환되어도 통신사가 번호이동을 접수하거나 완료했다는 증거는 아닙니다.
처리의 영향
검토된 핸들러는 저장된 이벤트를 읽으며, 프로젝트를 변경하거나 번호이동을 시작하거나 계정에서 요금을 차감하지 않습니다. 이벤트 쓰기 처리의 가시성과 인증된 계정을 사용한 테스트는 아직 완료되지 않은 계약 명세 검토의 대상으로 남아 있습니다.