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"
}
}이것은 가상의 예시이며 실제 계정 잔액이 아닙니다. 금액 값은 십진수로 처리하세요. 거부된 요청을 진단할 때는 자격 증명을 제거한 상태로 서버의 응답 메시지를 보관하세요.
청구 데이터를 올바르게 사용하세요
잔액 응답에는 현재 잔액, 통화, 결제 조건이 들어 있습니다. 향후 통화 비용이나 전체 청구서는 제공하지 않습니다. 그런 내용은 해당하는 요금 및 사용량 작업을 이용하세요. 기존 번호는 현재 카탈로그의 요금제와 다를 수 있습니다.
오류 및 재시도 처리
- 인증 또는 권한 실패
- API 자격 증명의 활성화 상태, 허용된 서비스, 소스 IP 제한을 확인하세요. 포털 세션 쿠키는 연동용 자격 증명이 아닙니다.
- 크레딧 부족 또는 승인 미충족
- 작업을 반복하기 전에 계정 잔액, 발송 승인 또는 문서 요건을 해결하세요.
- 결과 없음
- 비어 있는 재고나 확인되지 않는 발신자 이름은 정상적인 결과로 처리하세요. 구문상 유효한 번호가 모든 서비스를 지원한다고 가정하지 마세요.
- 네트워크 시간 초과 또는 서비스 장애
- 읽기 요청에는 백오프를 적용한 제한된 횟수의 재시도를 사용하세요. 구매, 발송 또는 등록의 경우 먼저 작업 상태를 확인하세요. 이미 접수된 요청을 재시도하면 과금되는 작업이 중복될 수 있습니다.
멱등성 지원은 API 계열마다 다릅니다. Emergency API는 재시도 키를 지원하지만, 그렇다고 임의의 v3 요청이 멱등적이 되는 것은 아닙니다. 지원 요청에 대비해 타임스탬프, 반환된 ID, 민감 정보를 제거한 응답을 보관하세요.
내 계정의 레퍼런스에서 계속하기
로그인한 상태의 레퍼런스는 사용자의 권한과 활성화된 서비스에 따라 작업을 필터링합니다. 해당 레퍼런스에 표시된 정확한 호스트, 자격 증명 유형, 요청 필드 및 응답 스키마를 사용하세요. 콘솔은 구매와 메시지 전송을 포함한 실제 작업을 실행할 수 있습니다.