Esta función le permite comprar un número de teléfono.
Si prefiere mantener la sencillez, basta con definir un URI ringto predeterminado (https://www.multitel.net/auth/setting , en la pestaña «URI Settings» (configuración de URI)) y luego llamar a la URL siguiente:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Una llamada a la API realizada correctamente devolverá el siguiente mensaje:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Una llamada a la API fallida devolverá uno de los siguientes mensajes:
{"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.Si necesita especificar más parámetros, siga leyendo:
POST URL: https://api.multitel.net/json/buynumbers/
Parámetros POST:
| UserName | Su nombre de usuario de inicio de sesión o su nombre de usuario de API |
| Password | Su contraseña de inicio de sesión o su contraseña de API |
| Number | El número de teléfono que desea comprar |
| Description | Descripción breve (si no se indica ninguna, se usa Number de forma predeterminada) |
| Type | Equivalente a «Destino de desvío (Forward Destination)» de la interfaz web. Los valores posibles son: 1 (para SIP) o 2 (para Dial) |
| RingType | 1 para Secuencial, 2 para Aleatorio, 3 para Simultáneo |
| Ringstyle | 1 para tono de llamada, 2 para música (Early Media) |
| URI | Primer URI SIP al que hacer sonar (o número de teléfono a marcar; sin prefijo 00/011/+, por favor) |
| URI2 | Segundo URI de SIP al que llamar |
| URI3 | Tercera URI SIP a la que se enviará la llamada |
| SMSRingType | 1 para correo electrónico, 2 para envío mediante POST a una URL |
| SMSURI | bien la dirección de correo electrónico, bien la URL de POST |
| FaxDetect | 1 para activado, 0 para desactivado . Si no se especifica, el valor predeterminado es 0 |
| FaxEmail | Correo electrónico al que reenviar el fax |
| FaxRing | ¿Cuántos segundos debemos escuchar para detectar tonos de fax? Valor predeterminado: 5 |
| Vm | ¿Buzón de voz habilitado? Valores posibles: 1 o 0 |
| Vmring | Cuántos segundos antes de que se active el buzón de voz |
| Vms2t | Transcripción de voz a texto del buzón de voz (Voicemail Speech 2 Text) -- 1 para activado, 0 para desactivado |
| Vmemail | Dirección de correo electrónico a la que reenviar los mensajes de voz |
| Cnam | Habilitar búsquedas CNAM (valores posibles 0 o 1; predeterminado 0) |
| Record | Grabar las conversaciones telefónicas (0 o 1, predeterminado 0) |
| Screening | Filtrar llamantes (pedirles que se identifiquen antes de conectarlos - valores posibles 0 o 1, por defecto 0 |
| Channels | ¿Cuántos canales necesitamos? El valor predeterminado es 2, a menos que el número solo tenga 1 canal disponible. Tenga en cuenta que para los números solo SMS (números sin capacidad VoIP), esta configuración no tiene efecto, por lo que no la establezca si no la va a necesitar. |
| Atcd | Detección automática de llamadas de telemarketing -- función que escucha llamadas automatizadas/robotizadas y cuelga si se detecta una llamada de este tipo. Valores posibles 1 o 0, valor predeterminado 0 |
| SID | ID de subcuenta (Sub Account ID) — defina sus subcuentas en https://www.multitel.net/auth/setting/ en la pestaña Subcuentas (SubAccounts) |
URL de GET:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... etc
Tenga en cuenta que los parámetros utilizados para GET son exactamente los mismos que los parámetros utilizados para POST y deben utilizarse en el orden exacto en que se enumeran en
la tabla anterior.
Recomendamos encarecidamente que utilice POST en lugar de GET, ya que minimiza el riesgo de intercambiar parámetros.