Questa funzione consente di acquistare un numero di telefono.
Se vuoi mantenere le cose semplici, basta definire un URI ringto predefinito (https://www.multitel.net/auth/setting , nella scheda "URI Settings" (impostazioni URI)) e poi chiamare l'URL qui sotto:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Una chiamata API riuscita restituirà il seguente messaggio:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Una chiamata all’API non riuscita restituirà uno dei seguenti messaggi:
{"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.Se devi specificare altri parametri, continua a leggere:
POST URL: https://api.multitel.net/json/buynumbers/
Parametri POST:
| UserName | Il tuo nome utente di accesso o il tuo nome utente API |
| Password | La password di accesso o la password API |
| Number | Il numero di telefono che desideri acquistare |
| Description | Descrizione breve (se non indicata, il valore predefinito è Number) |
| Type | Equivalente a «Destinazione di inoltro (Forward Destination)» dell'interfaccia web. I valori possibili sono: 1 (per SIP) o 2 (per Dial) |
| RingType | 1 per Sequenziale , 2 per Casuale , 3 per Simultaneo |
| Ringstyle | 1 per Squillo, 2 per Musica (Early Media) |
| URI | Primo URI SIP da far squillare (o numero di telefono da comporre -- senza prefisso 00/011/+) |
| URI2 | Secondo SIP URI da chiamare |
| URI3 | Terzo URI SIP a cui inviare la chiamata |
| SMSRingType | 1 per e-mail, 2 per invio tramite POST a un URL |
| SMSURI | o l’indirizzo e-mail, o l’URL POST |
| FaxDetect | 1 per abilitato, 0 per disabilitato. Se non specificato, il valore predefinito è 0 |
| FaxEmail | E-mail a cui inoltrare il fax |
| FaxRing | Per quanti secondi dobbiamo restare in ascolto dei toni fax? Il valore predefinito è 5 |
| Vm | Casella vocale abilitata? Valori possibili 1 o 0 |
| Vmring | Dopo quanti secondi interviene la segreteria (VM) |
| Vms2t | Trascrizione da voce a testo della segreteria (Voicemail Speech 2 Text) -- 1 per abilitato, 0 per disabilitato |
| Vmemail | Indirizzo e-mail a cui inoltrare i messaggi vocali |
| Cnam | Abilita le ricerche CNAM (valori possibili 0 o 1 - predefinito 0) |
| Record | Registra le conversazioni telefoniche (0 o 1, valore predefinito 0) |
| Screening | Filtra i chiamanti (chiedi loro di identificarsi prima di essere connessi - valori possibili 0 o 1, predefinito 0 |
| Channels | Di quanti canali abbiamo bisogno? Il valore predefinito è 2, a meno che il numero non abbia disponibile 1 solo canale. Tieni presente che per i numeri solo SMS (numeri privi di capacità VoIP) questa impostazione non ha alcun effetto, quindi non impostarla se non ti serve. |
| Atcd | Rilevamento automatico delle chiamate di telemarketing -- funzionalità che rileva le chiamate automatizzate o robotizzate e riaggancia se viene rilevata tale chiamata. Valori possibili 1 o 0, valore predefinito 0 |
| SID | ID del sottoaccount (Sub Account ID) — definisci i sottoaccount in https://www.multitel.net/auth/setting/ nella scheda Sottoaccount (SubAccounts) |
URL per GET:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... ecc.
Si noti che i parametri utilizzati per GET sono esattamente gli stessi dei parametri utilizzati per POST e devono essere utilizzati nell'esatto ordine in cui sono elencati in
la tabella sopra.
Ti consigliamo vivamente di utilizzare POST invece di GET, poiché riduce al minimo il rischio di invertire i parametri.