이 기능을 사용하면 전화번호를 구매할 수 있습니다.
간단하게 설정하려면 기본 ringto URI(착신 대상 URI)를 지정한 뒤(https://www.multitel.net/auth/setting, "URI Settings" — URI 설정 — 탭), 아래 URL을 호출하면 됩니다.
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
API 호출이 성공하면 다음 메시지가 반환됩니다:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890통화에 실패하면 다음 메시지 중 하나가 반환됩니다:
{"DATA":[{"RETURN":99}]} <== not enough balance to purchase number{"DATA":[{"RETURN":100}]} <== not authenticated (Check username/password){"DATA":[{"RETURN":-165}]} <== number has already been sold (check your account, possibly you hit the refresh button twice and you already purchased the number?){"DATA":[{"RETURN":-220}]} <== number is reserved (might happen when number was just released, please try again in a few minutes){"DATA":[{"RETURN":-275}]} <== this number does not exist in our inventory anymore{"DATA":[{"RETURN":-1210}]} <== number not cleared{"DATA":[{"RETURN":-1265}]} <== documentation required - usually proof of address / ID card copy (please contact us for more info.추가 매개변수를 지정해야 하는 경우 계속 읽으십시오:
POST URL: https://api.multitel.net/json/buynumbers/
POST 매개변수:
| UserName | 로그인 사용자 이름 또는 API 사용자 이름 |
| Password | 로그인 비밀번호 또는 API 비밀번호 |
| Number | 구매하려는 전화번호 |
| Description | 짧은 설명(입력하지 않으면 기본값은 Number) |
| Type | 웹 인터페이스의 "Forward Destination"(착신 전환 대상)과 같습니다. 가능한 값은 1(SIP) 또는 2(Dial)입니다. |
| RingType | 1은 Sequential(순차), 2는 Random(무작위), 3은 Simultaneous(동시) |
| Ringstyle | 1은 링, 2는 음악(Early Media) |
| URI | 먼저 호출할 SIP URI(또는 전화할 전화번호 -- 00/011/+ 접두사는 붙이지 마십시오) |
| URI2 | 울릴 두 번째 SIP URI |
| URI3 | 세 번째로 호출할 SIP URI |
| SMSRingType | 이메일 전송은 1, URL로 POST 요청을 보내는 방식은 2 |
| SMSURI | 이메일 주소 또는 POST URL 중 하나 |
| FaxDetect | 활성화는 1, 비활성화는 0입니다. 지정하지 않으면 기본값은 0입니다. |
| FaxEmail | 팩스를 전달할 이메일 |
| FaxRing | 팩스 신호음을 몇 초 동안 수신해야 합니까? 기본값은 5입니다 |
| Vm | 음성 메일 사용 여부? 가능한 값은 1 또는 0 |
| Vmring | 음성사서함이 작동하기까지의 시간(초) |
| Vms2t | 음성사서함 음성-텍스트 변환(Voicemail Speech 2 Text) -- 1은 사용, 0은 사용 안 함 |
| Vmemail | 음성사서함을 전달할 이메일 주소 |
| Cnam | CNAM 조회 활성화(가능한 값은 0 또는 1이며 기본값은 0) |
| Record | 통화 녹음(0 또는 1, 기본값은 0) |
| Screening | 발신자 스크리닝(연결되기 전에 신원을 밝히도록 요청 - 가능한 값은 0 또는 1이며, 기본값은 0) |
| Channels | 필요한 채널 수는 몇 개입니까? 번호에 사용 가능한 채널이 1개뿐인 경우가 아니라면 기본값은 2입니다. SMS 전용 번호(VoIP 기능이 없는 번호)의 경우 이 설정은 아무 효과가 없으므로 필요하지 않다면 설정하지 마세요. |
| Atcd | 자동 텔레마케터 통화 감지 -- 자동/로보 통화를 감지하고, 감지되면 통화를 끊는 기능입니다. 가능한 값은 1 또는 0이며 기본값은 0입니다 |
| SID | 하위 계정 ID -- 하위 계정은 https://www.multitel.net/auth/setting/의 하위 계정 (SubAccounts) 탭에서 정의하세요 |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... 등
GET에 사용되는 매개변수는 POST에 사용되는 매개변수와 정확히 동일하며, 나열된 순서 그대로 정확히 사용해야 합니다.
위 표.
파라미터가 뒤바뀔 위험을 최소화할 수 있으므로 GET 대신 POST를 사용할 것을 강력히 권장합니다.