Chức năng này sẽ cho phép bạn mua số điện thoại.
Để thiết lập đơn giản, hãy xác định ringto URI mặc định, tức URI đích nhận cuộc gọi (https://www.multitel.net/auth/setting, trong thẻ "URI Settings" — cài đặt URI), rồi gọi URL bên dưới:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Một lệnh gọi API thành công sẽ trả về thông báo sau:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Cuộc gọi không thành công sẽ trả về một trong các thông báo sau:
{"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.Nếu bạn cần chỉ định thêm tham số, hãy đọc tiếp:
POST URL: https://api.multitel.net/json/buynumbers/
Tham số POST:
| UserName | Tên người dùng đăng nhập của bạn hoặc Tên người dùng API của bạn |
| Password | Mật khẩu đăng nhập của bạn hoặc mật khẩu API của bạn |
| Number | Số điện thoại bạn muốn mua |
| Description | Mô tả ngắn (nếu không cung cấp, mặc định là Number) |
| Type | Tương đương với "Forward Destination" (đích chuyển cuộc gọi) trên giao diện web. Giá trị có thể là 1 (SIP) hoặc 2 (Dial). |
| RingType | 1 cho Tuần tự, 2 cho Ngẫu nhiên, 3 cho Đồng thời |
| Ringstyle | 1 là Ring (đổ chuông), 2 là Music (nhạc) (Early Media) |
| URI | SIP URI đầu tiên để đổ chuông (hoặc số điện thoại cần gọi -- vui lòng không dùng tiền tố 00/011/+) |
| URI2 | SIP URI thứ hai để đổ chuông |
| URI3 | SIP URI thứ ba để đổ chuông |
| SMSRingType | 1 cho email, 2 cho yêu cầu POST đến một URL |
| SMSURI | hoặc địa chỉ E-Mail, hoặc URL POST |
| FaxDetect | 1 là bật, 0 là tắt. Nếu không chỉ định, mặc định là 0 |
| FaxEmail | Email để chuyển tiếp fax |
| FaxRing | Chúng ta nên lắng nghe âm fax trong bao nhiêu giây? Mặc định là 5 |
| Vm | Đã bật hộp thư thoại (VoiceMail)? Giá trị có thể là 1 hoặc 0 |
| Vmring | Số giây trước khi thư thoại (VM) được kích hoạt |
| Vms2t | Chuyển thư thoại thành văn bản (Voicemail Speech 2 Text) -- 1 để bật, 0 để tắt |
| Vmemail | Địa chỉ email để chuyển tiếp thư thoại đến |
| Cnam | Bật tra cứu CNAM (giá trị có thể là 0 hoặc 1 - mặc định là 0) |
| Record | Ghi âm cuộc gọi điện thoại (0 hoặc 1, mặc định là 0) |
| Screening | Sàng lọc người gọi (yêu cầu họ xưng danh trước khi được kết nối - giá trị có thể là 0 hoặc 1, mặc định là 0) |
| Channels | Chúng ta cần bao nhiêu kênh? Mặc định là 2 trừ khi số chỉ có sẵn 1 kênh. Xin lưu ý rằng đối với các số chỉ dùng SMS (số không có khả năng VoIP), cài đặt này không có tác dụng, vì vậy đừng đặt nếu bạn không cần. |
| Atcd | Tự động phát hiện cuộc gọi tiếp thị -- tính năng nhận diện cuộc gọi tự động hoặc cuộc gọi bằng giọng nói ghi sẵn và ngắt cuộc gọi khi phát hiện. Giá trị có thể là 1 hoặc 0, mặc định là 0. |
| SID | Tài khoản phụ ID -- hãy định nghĩa các tài khoản phụ của bạn tại https://www.multitel.net/auth/setting/ trong tab Tài khoản phụ (SubAccounts) |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... v.v.
Xin lưu ý rằng các tham số dùng cho GET hoàn toàn giống với các tham số dùng cho POST và cần được sử dụng theo đúng thứ tự như được liệt kê trong
bảng ở trên.
Chúng tôi đặc biệt khuyến nghị bạn dùng POST thay vì GET vì cách này giảm thiểu nguy cơ nhầm lẫn thứ tự các tham số.