REST API 문서
첫 MultiTEL 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.multitel.net/v3/getbalance"커뮤니케이션 v3 API는 JSON 본문 안에 애플리케이션 결과를 반환합니다. response를 읽기 전에 HTTP 상태와 status.code를 확인하세요. 거부된 요청에는 응답 객체가 없을 수 있습니다. 코드 값은 문자열일 수도 있고 숫자일 수도 있습니다.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"balance": "25.0000",
"currency": "USD",
"terms": "Prepaid"
}
}이것은 가상의 예시이며 실제 계정 잔액이 아닙니다. 금액 값은 십진수로 처리하세요. 거부된 요청을 진단할 때는 자격 증명을 제거한 상태로 서버의 응답 메시지를 보관하세요.
청구 데이터를 올바르게 사용하세요
잔액 응답에는 현재 잔액, 통화, 결제 조건이 들어 있습니다. 향후 통화 비용이나 전체 청구서는 제공하지 않습니다. 그런 내용은 해당하는 요금 및 사용량 작업을 이용하세요. 기존 번호는 현재 카탈로그의 요금제와 다를 수 있습니다.
다음 연동 선택하기
LRN 라우팅 조회 REST API
북미 전화번호의 라우팅 번호와 확인 가능한 통신사 정보를 균일한 조회 단가로 조회하세요.
연동 가이드 읽기 →전화번호 REST API
이용 가능한 국가와 번호를 찾고, 전체 상품 내용을 확인하고, 보유한 번호를 관리하세요.
연동 가이드 읽기 →SMS 및 MMS REST API
승인된 애플리케이션 메시지를 전송하고, 접수, 전달 이벤트, 분할 및 요금을 처리하세요.
연동 가이드 읽기 →긴급 통화 REST API
번호와 서비스 주소를 등록하고, 활성화 상태를 확인하고, 위치가 바뀔 때마다 기록을 최신 상태로 유지하세요.
연동 가이드 읽기 →계정 및 청구 REST API
승인된 연동에서 사용할 수 있는 잔액 및 청구 정보를 조회하세요.
연동 가이드 읽기 →CNAM 및 라우팅 조회
발신자 이름을 읽고, 조회 등급을 이해하고, 번호 라우팅 정보를 활용하세요.
CNAM REST 레퍼런스 →호스티드 PBX
이용 가능한 서비스 요금제와 구성하려는 테넌트부터 시작하세요.
호스티드 PBX 서비스 요금제 API →오류 및 재시도 처리
- 인증 또는 권한 실패
- API 자격 증명의 활성화 상태, 허용된 서비스, 소스 IP 제한을 확인하세요. 포털 세션 쿠키는 연동용 자격 증명이 아닙니다.
- 크레딧 부족 또는 승인 미충족
- 작업을 반복하기 전에 계정 잔액, 발송 승인 또는 문서 요건을 해결하세요.
- 결과 없음
- 비어 있는 재고나 확인되지 않는 발신자 이름은 정상적인 결과로 처리하세요. 구문상 유효한 번호가 모든 서비스를 지원한다고 가정하지 마세요.
- 네트워크 시간 초과 또는 서비스 장애
- 읽기 요청에는 백오프를 적용한 제한된 횟수의 재시도를 사용하세요. 구매, 발송 또는 등록의 경우 먼저 작업 상태를 확인하세요. 이미 접수된 요청을 재시도하면 과금되는 작업이 중복될 수 있습니다.
멱등성 지원은 API 계열마다 다릅니다. Emergency API는 재시도 키를 지원하지만, 그렇다고 임의의 v3 요청이 멱등적이 되는 것은 아닙니다. 지원 요청에 대비해 타임스탬프, 반환된 ID, 민감 정보를 제거한 응답을 보관하세요.
내 계정의 레퍼런스에서 계속하기
로그인한 상태의 레퍼런스는 사용자의 권한과 활성화된 서비스에 따라 작업을 필터링합니다. 해당 레퍼런스에 표시된 정확한 호스트, 자격 증명 유형, 요청 필드 및 응답 스키마를 사용하세요. 콘솔은 구매와 메시지 전송을 포함한 실제 작업을 실행할 수 있습니다.