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 통합 설정에서 관리합니다.
번호 조회
GET /v3/lrn/{number}는 경로에 대상 번호를 받습니다. 발신 번호에 따라 달라지는 정보가 필요하면 선택 사항인 발신 번호를 /v3/lrn/{number}/{ani}로 지정할 수 있습니다. 해당하는 경우 국가 코드를 포함한 북미 전화번호를 숫자만으로 입력하세요. 예시에는 예약된 가상의 번호를 사용합니다.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123"curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123/12025550124"유효한 자격 증명으로 조회를 실행하면 요금이 부과됩니다. 요금은 조회당 US$0.00025이며, 1,000건당 US$0.25 또는 100만 건당 US$250입니다. 대량 할인은 없습니다. 이는 라우팅 정보 조회이며 전화를 걸지 않습니다.
결과 읽기
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"lrn": "12025550123",
"ported": 0,
"ocn": "",
"lata": "",
"rc": "",
"cost": "$0.00025"
}
}이 가상의 예시는 응답 형태만 보여 주며 실제로 측정한 라우팅 결과가 아닙니다. response를 사용하기 전에 status.code를 확인하세요. cost 필드는 JSON 숫자가 아니라 통화 기호가 앞에 붙은 문자열입니다.
| 필드 | 의미 |
|---|---|
lrn | 라우팅 대상을 식별하는 데 사용하는 Location Routing Number입니다. |
ported | 이 조회에서 제공하는 번호 이동 표시자이며, 일반적으로 0 또는 1입니다. 소유권이나 서비스 자격의 증거로 사용하지 마세요. |
ocn | 제공되는 경우의 Operating Company Number입니다. |
lata | 제공되는 경우의 Local Access and Transport Area입니다. |
rc | 제공되는 경우의 요금 센터(rate center)입니다. |
city, state, lec, lectype, jurisdiction, local | 가능한 경우 제공되는 추가 위치, 통신사 또는 발신 관련 세부 정보입니다. 없거나 비어 있을 수 있습니다. |
모든 라우팅 필드가 존재해야 한다고 요구하지 마세요. 특히 수신자 부담(toll-free) 결과에는 지역 요금 센터와 통신사 코드 정보가 없을 수 있습니다. 반환된 LRN은 실시간 도달 가능성을 보장하거나 통화 품질을 테스트한 결과가 아닙니다.
라우팅 워크플로에서 조회 활용하기
- 요청할 번호를 보내기 전에 검증하고 정규화하세요.
- HTTP 상태와 애플리케이션 상태를 모두 확인하세요. 문제 해결을 위해 번호, 시간, 결과를 민감 정보를 제거한 기록으로 보관하세요.
- 라우팅 규칙에 관련된 필드만 사용하고, 값이 없는 경우를 명시적으로 처리하세요.
- 응답이 불확실한 경우 재시도 횟수를 제한하세요. 조회를 반복하면 다시 요금이 부과될 수 있으며, 이 엔드포인트에는 문서화된 멱등성 키가 없습니다.
LRN 제품 및 균일한 조회 단가 보기. 공개 OpenAPI 경로에는 ANI 세그먼트가 포함되어 있으며, 배포된 LRN 구현은 ANI가 없는 더 짧은 요청도 허용합니다. lrninfo는 별도의 작업이므로 이 엔드포인트 대신 사용해서는 안 됩니다.
오류 및 재시도 처리
- 인증 또는 권한 실패
- API 자격 증명의 활성화 상태, 허용된 서비스, 소스 IP 제한을 확인하세요. 포털 세션 쿠키는 연동용 자격 증명이 아닙니다.
- 크레딧 부족 또는 승인 미충족
- 작업을 반복하기 전에 계정 잔액, 발송 승인 또는 문서 요건을 해결하세요.
- 결과 없음
- 비어 있는 재고나 확인되지 않는 발신자 이름은 정상적인 결과로 처리하세요. 구문상 유효한 번호가 모든 서비스를 지원한다고 가정하지 마세요.
- 네트워크 시간 초과 또는 서비스 장애
- 읽기 요청에는 백오프를 적용한 제한된 횟수의 재시도를 사용하세요. 구매, 발송 또는 등록의 경우 먼저 작업 상태를 확인하세요. 이미 접수된 요청을 재시도하면 과금되는 작업이 중복될 수 있습니다.
멱등성 지원은 API 계열마다 다릅니다. Emergency API는 재시도 키를 지원하지만, 그렇다고 임의의 v3 요청이 멱등적이 되는 것은 아닙니다. 지원 요청에 대비해 타임스탬프, 반환된 ID, 민감 정보를 제거한 응답을 보관하세요.
내 계정의 레퍼런스에서 계속하기
로그인한 상태의 레퍼런스는 사용자의 권한과 활성화된 서비스에 따라 작업을 필터링합니다. 해당 레퍼런스에 표시된 정확한 호스트, 자격 증명 유형, 요청 필드 및 응답 스키마를 사용하세요. 콘솔은 구매와 메시지 전송을 포함한 실제 작업을 실행할 수 있습니다.