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/getcountries"v3 응답에는 status와 response 배열이 들어 있습니다. 국가 항목에는 isocode, name, countrycode, 기능 정보, next_function이 포함됩니다. 제공 여부는 계정과 재고에 따라 달라지며, 국가가 목록에 있다고 해서 모든 접두사나 번호 유형의 재고가 있다는 뜻은 아닙니다.
{
"status": {
"code": 200,
"msg": "Results: 1"
},
"response": [
{
"countrycode": "1",
"name": "United States",
"description": "United States",
"isocode": "US",
"is_mobile": 0,
"sms_coverage": 1,
"latitude": "37.0902",
"longitude": "-95.7129",
"next_function": "v3/getareas/US"
}
]
}탐색에서 활성화까지
- 해당 지역 작업을 사용하여 국가, 필요한 경우 하위 행정 구역, 지역, 번호 유형을 선택하세요.
- 선택한 번호의 설정 요금, 월 요금, 사용 요금, 채널, 허용량, 등록 요건을 확인하세요.
- 필요한 최종 사용자 문서를 제출하고 상태를 확인하세요. 승인될 때까지 번호가 보류 상태로 남아 있을 수 있습니다.
- 정확한 재고 및 가격 선택으로 한 번만 주문하세요. 응답이 불확실하면 다른 주문을 제출하기 전에 재고를 확인하세요.
- 음성 라우팅과 메시지 전달을 각각 독립적으로 구성한 다음, 의도한 전체 경로를 테스트하세요.
오류 및 재시도 처리
- 인증 또는 권한 실패
- API 자격 증명의 활성화 상태, 허용된 서비스, 소스 IP 제한을 확인하세요. 포털 세션 쿠키는 연동용 자격 증명이 아닙니다.
- 크레딧 부족 또는 승인 미충족
- 작업을 반복하기 전에 계정 잔액, 발송 승인 또는 문서 요건을 해결하세요.
- 결과 없음
- 비어 있는 재고나 확인되지 않는 발신자 이름은 정상적인 결과로 처리하세요. 구문상 유효한 번호가 모든 서비스를 지원한다고 가정하지 마세요.
- 네트워크 시간 초과 또는 서비스 장애
- 읽기 요청에는 백오프를 적용한 제한된 횟수의 재시도를 사용하세요. 구매, 발송 또는 등록의 경우 먼저 작업 상태를 확인하세요. 이미 접수된 요청을 재시도하면 과금되는 작업이 중복될 수 있습니다.
멱등성 지원은 API 계열마다 다릅니다. Emergency API는 재시도 키를 지원하지만, 그렇다고 임의의 v3 요청이 멱등적이 되는 것은 아닙니다. 지원 요청에 대비해 타임스탬프, 반환된 ID, 민감 정보를 제거한 응답을 보관하세요.
내 계정의 레퍼런스에서 계속하기
로그인한 상태의 레퍼런스는 사용자의 권한과 활성화된 서비스에 따라 작업을 필터링합니다. 해당 레퍼런스에 표시된 정확한 호스트, 자격 증명 유형, 요청 필드 및 응답 스키마를 사용하세요. 콘솔은 구매와 메시지 전송을 포함한 실제 작업을 실행할 수 있습니다.