Această funcție vă permite să cumpărați un număr de telefon.
Pentru o configurare simplă, definiți o adresă URI de destinație implicită (ringto) (https://www.multitel.net/auth/setting, în fila „URI Settings”), apoi apelați URL-ul API de mai jos:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Un apel API reușit returnează următorul mesaj:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Un apel API nereușit va returna unul dintre următoarele mesaje:
{"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.Dacă trebuie să specificați mai mulți parametri, citiți mai departe:
URL POST: https://api.multitel.net/json/buynumbers/
Parametri POST:
| UserName | Numele dvs. de utilizator pentru autentificare sau numele dvs. de utilizator API |
| Password | Parola dvs. de conectare sau parola dvs. API |
| Number | Numărul de telefon pe care doriți să îl cumpărați |
| Description | Descriere scurtă (dacă nu este furnizată, implicit este Number) |
| Type | Echivalent cu „Destinație de redirecționare (Forward Destination)” din interfața web. Valorile posibile sunt: 1 (pentru SIP) sau 2 (pentru Dial) |
| RingType | 1 pentru Secvențial, 2 pentru Aleatoriu, 3 pentru Simultan |
| Ringstyle | 1 pentru sonerie, 2 pentru muzică înainte de răspuns (Early Media) |
| URI | Primul URI SIP care să sune (sau numărul de telefon de apelat -- fără prefix 00/011/+, vă rugăm) |
| URI2 | Al doilea URI SIP de apelat |
| URI3 | Al treilea URI SIP către care se trimite apelul |
| SMSRingType | 1 pentru e-mail, 2 pentru trimitere prin POST către un URL |
| SMSURI | fie adresa de e-mail, fie URL-ul POST |
| FaxDetect | 1 pentru activat, 0 pentru dezactivat. Dacă nu este specificat, valoarea implicită este 0 |
| FaxEmail | Adresa de e-mail la care se redirecționează faxul |
| FaxRing | Câte secunde ar trebui să ascultăm tonurile de fax? Valoarea implicită este 5 |
| Vm | Mesagerie vocală activată? Valori posibile 1 sau 0 |
| Vmring | Câte secunde până când intră căsuța vocală (VM) |
| Vms2t | Transcrierea mesajelor vocale (Voicemail Speech 2 Text) -- 1 pentru activat, 0 pentru dezactivat |
| Vmemail | Adresa de e-mail către care se redirecționează mesajele vocale |
| Cnam | Activați căutările CNAM (valori posibile 0 sau 1 - implicit 0) |
| Record | Înregistrați conversațiile telefonice (0 sau 1, implicit 0) |
| Screening | Filtrarea apelanților (li se cere să se identifice înainte de a fi conectați - valori posibile 0 sau 1, implicit 0 |
| Channels | Câte canale ne trebuie? Implicit 2, cu excepția cazului în care numărul are disponibil 1 singur canal. Rețineți că pentru numerele doar SMS (numere fără capacitate VoIP), această setare nu are niciun efect, așa că nu o setați dacă nu aveți nevoie de ea. |
| Atcd | Detectarea automată a apelurilor de telemarketing -- funcție care ascultă apelurile automate/robotizate și închide dacă este detectat un astfel de apel. Valorile posibile sunt 1 sau 0, implicit 0 |
| SID | ID-ul subcontului (Sub Account ID) — definiți subconturile la https://www.multitel.net/auth/setting/ în fila Subconturi (SubAccounts) |
URL pentru GET:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... etc.
Rețineți că parametrii utilizați pentru GET sunt exact aceiași cu parametrii utilizați pentru POST și trebuie utilizați exact în ordinea în care sunt enumerați în
tabelul de mai sus.
Vă recomandăm insistent să utilizați POST în loc de GET, deoarece acest lucru reduce la minimum riscul de inversare a parametrilor.