REST API 문서
긴급 통화 REST API
번호와 서비스 주소를 등록하고, 활성화 상태를 확인하고, 위치가 바뀔 때마다 기록을 최신 상태로 유지하세요.
API와 자격 증명을 함께 선택하세요
승인된 개발자 및 자동화, 비즈니스, 통신 사업자 계정은 활성화된 서비스를 연동할 수 있습니다. 개인 개발자가 회사인 것처럼 가장할 필요는 없습니다. 애플리케이션 SMS/MMS에는 해당 발송 승인과 등록이 필요합니다. 개인 및 가족 서비스에는 고객이 사용할 수 있는 메시지 발신용 API가 없습니다.
| API 계열 | 기본 URL | 인증 및 결과 |
|---|---|---|
| 커뮤니케이션 v3 | https://api.multitel.net/v3 | 승인된 Basic 자격 증명이며, 지원하는 작업에 한해 사용 가능한 프로비저닝된 토큰을 쓸 수 있습니다. JSON status 및 response. |
| 긴급 서비스 등록 | https://api.multi.tel/emergency | 승인된 Basic 자격 증명 또는 별도로 프로비저닝된 bearer 접근 권한입니다. JSON code, message, data. |
| 포털 REST 연동 | 계정의 개발자 레퍼런스에 표시된 호스트와 작업 | 해당 작업에 문서화된 자격 증명, 스코프, 스키마를 사용하세요. 브라우저 세션 요청은 별도의 인터페이스입니다. |
예시를 사용하기 전에 서버의 시크릿 설정을 통해 MULTITEL_API_USERNAME과 MULTITEL_API_PASSWORD를 지정하세요. 공개 브라우저 JavaScript, URL, 소스 관리에는 절대 포함하지 마세요. 전용 자격 증명은 API 통합 설정에서 관리합니다.
번호를 등록하지 않고 지원 범위 읽기
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multi.tel/emergency/coverage?environment=production"https://api.multitel.net/emergency도 지원됩니다. 두 긴급 서비스 기본 URL 모두 /v3를 포함하지 않습니다. 지원 범위에는 국제 서비스 대상 국가, 지원되는 번호 유형, 요금이 나열되며, 북미 E911 자격은 등록 시 확인됩니다.
{
"code": 200,
"message": "",
"environment": "production",
"requestId": "EXAMPLE_REQUEST_ID",
"data": {}
}이 예시는 응답 구조만 보여 줍니다. 각 작업의 data 스키마는 게시된 Emergency API 가이드에서 확인하세요.
등록하고, 상태를 확인한 다음, 통화 설정하기
- 미국/캐나다 및 지원되는 기타 북미 E911 지역에서는 번호, E911 주소, 필요한 동의 확인을 제공하세요. 북미 E911은 프로덕션 환경 전용입니다.
- 지원되는 소유 국제 번호의 경우 저장된 문서 참조 또는 최종 사용자의 신원과 주소 중 하나를 제공하세요. 먼저 국가 및 번호 유형별 요건을 확인하세요.
POST /registrations요청을 한 번 보내세요. 선택 사항인Idempotency-Key는 하나의 논리적 변경 작업을 식별하며, 재시도할 때도 이 키와 동일한 페이로드를 그대로 유지하세요.GET /registrations/:number를 읽으세요. 수명 주기,pending,actionRequired를 확인하고 필요한 수정 사항을 해결하세요. 접수 또는 보류 상태는 서비스가 활성화되었다는 뜻이 아닙니다.- 활성화한 후 올바른 긴급 발신자 ID와 국가별 다이얼링 경로를 설정하세요. 서비스에서 제공하는 비긴급 확인 절차를 사용하세요.
국제 샌드박스 등록은 격리되어 있으며 실제 긴급 통화를 활성화하지 않습니다. 북미 E911에는 메인 계정 자격 증명이 필요하며, 제한적인 국제 하위 계정 지원은 가이드에 설명되어 있습니다.
오류 및 재시도 처리
- 인증 또는 권한 실패
- API 자격 증명의 활성화 상태, 허용된 서비스, 소스 IP 제한을 확인하세요. 포털 세션 쿠키는 연동용 자격 증명이 아닙니다.
- 크레딧 부족 또는 승인 미충족
- 작업을 반복하기 전에 계정 잔액, 발송 승인 또는 문서 요건을 해결하세요.
- 결과 없음
- 비어 있는 재고나 확인되지 않는 발신자 이름은 정상적인 결과로 처리하세요. 구문상 유효한 번호가 모든 서비스를 지원한다고 가정하지 마세요.
- 네트워크 시간 초과 또는 서비스 장애
- 읽기 요청에는 백오프를 적용한 제한된 횟수의 재시도를 사용하세요. 구매, 발송 또는 등록의 경우 먼저 작업 상태를 확인하세요. 이미 접수된 요청을 재시도하면 과금되는 작업이 중복될 수 있습니다.
멱등성 지원은 API 계열마다 다릅니다. Emergency API는 재시도 키를 지원하지만, 그렇다고 임의의 v3 요청이 멱등적이 되는 것은 아닙니다. 지원 요청에 대비해 타임스탬프, 반환된 ID, 민감 정보를 제거한 응답을 보관하세요.
내 계정의 레퍼런스에서 계속하기
로그인한 상태의 레퍼런스는 사용자의 권한과 활성화된 서비스에 따라 작업을 필터링합니다. 해당 레퍼런스에 표시된 정확한 호스트, 자격 증명 유형, 요청 필드 및 응답 스키마를 사용하세요. 콘솔은 구매와 메시지 전송을 포함한 실제 작업을 실행할 수 있습니다.