ฟังก์ชันนี้จะช่วยให้คุณสามารถซื้อหมายเลขโทรศัพท์ได้
หากต้องการตั้งค่าแบบง่าย ให้กำหนด 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 สำหรับการโทรตามลำดับ, 2 สำหรับการโทรแบบสุ่ม, 3 สำหรับการโทรพร้อมกัน |
| Ringstyle | 1 สำหรับเสียงเรียกเข้า (Ring), 2 สำหรับเพลง (Early Media) |
| URI | SIP URI แรกที่จะให้เสียงเรียกเข้า (หรือหมายเลขโทรศัพท์ที่จะโทรออก -- กรุณาไม่ใส่คำนำหน้า 00/011/+) |
| URI2 | SIP URI ที่สองที่จะให้เรียกเข้า |
| URI3 | SIP URI ที่สามที่จะให้ดังเรียก |
| SMSRingType | 1 สำหรับอีเมล และ 2 สำหรับการส่งคำขอ POST ไปยัง URL |
| SMSURI | ไม่ว่าจะเป็นที่อยู่ E-Mail หรือ URL แบบ POST |
| FaxDetect | 1 สำหรับเปิดใช้งาน 0 สำหรับปิดใช้งาน หากไม่ได้ระบุไว้ ค่าเริ่มต้นคือ 0 |
| FaxEmail | อีเมลสำหรับส่งต่อแฟกซ์ |
| FaxRing | เราควรฟังเสียงแฟกซ์นานกี่วินาที? ค่าเริ่มต้นคือ 5 |
| Vm | เปิดใช้งาน ข้อความเสียง หรือไม่? ค่าที่เป็นไปได้คือ 1 หรือ 0 |
| Vmring | กี่วินาทีก่อนที่ VM จะเริ่มทำงาน |
| Vms2t | แปลงข้อความเสียงเป็นตัวอักษร (Voicemail Speech 2 Text) -- 1 คือเปิดใช้งาน, 0 คือปิดใช้งาน |
| Vmemail | ที่อยู่อีเมลที่ใช้ส่งต่อข้อความเสียง |
| Cnam | เปิดใช้การค้นหา CNAM (ค่าที่เป็นไปได้คือ 0 หรือ 1 - ค่าเริ่มต้นคือ 0) |
| Record | บันทึกการสนทนาทางโทรศัพท์ (0 หรือ 1, ค่าเริ่มต้นคือ 0) |
| Screening | คัดกรองผู้โทร (ขอให้ผู้โทรระบุตัวตนก่อนเชื่อมต่อสาย - ค่าที่เป็นไปได้คือ 0 หรือ 1 ค่าเริ่มต้นคือ 0) |
| Channels | เราต้องการกี่ช่องสัญญาณ ค่าเริ่มต้นคือ 2 เว้นแต่หมายเลขจะมีเพียง 1 ช่องสัญญาณ โปรดทราบว่าสำหรับหมายเลขสำหรับ 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 ทุกประการ และควรใช้ตามลำดับที่แสดงไว้ใน
ตารางด้านบน
เราขอแนะนำอย่างยิ่งให้ใช้ POST แทน GET เนื่องจากช่วยลดความเสี่ยงที่พารามิเตอร์จะสลับตำแหน่งกัน