Esta função permitirá que você compre um número de telefone.
Se você prefere manter as coisas simples, basta definir um URI ringto padrão (https://www.multitel.net/auth/setting , na guia "URI Settings" (configurações de URI)) e chamar o URL abaixo:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Uma chamada à API bem-sucedida devolverá a seguinte mensagem:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Uma chamada à API sem sucesso retornará uma das seguintes mensagens:
{"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 você precisar especificar mais parâmetros, continue lendo:
POST URL: https://api.multitel.net/json/buynumbers/
Parâmetros POST:
| UserName | Seu nome de usuário de login ou seu nome de usuário de API |
| Password | Sua senha de login ou sua senha de API |
| Number | O número de telefone que você deseja comprar |
| Description | Descrição curta (se não for fornecida, assume o valor do campo Number) |
| Type | Equivalente a 'Destino de encaminhamento (Forward Destination)' da interface web. Valores possíveis são: 1 (para SIP) ou 2 (para Dial) |
| RingType | 1 para Sequencial, 2 para Aleatório, 3 para Simultâneo |
| Ringstyle | 1 para toque, 2 para música (Early Media) |
| URI | Primeiro URI SIP a tocar (ou número de telefone a marcar -- sem prefixo 00/011/+, por favor) |
| URI2 | Segundo SIP URI para chamar |
| URI3 | Terceiro URI SIP para o qual encaminhar a chamada |
| SMSRingType | 1 para e-mail, 2 para envio por POST a uma URL |
| SMSURI | endereço de e-mail ou o URL POST |
| FaxDetect | 1 para ativado, 0 para desativado. Se não for especificado, o valor predefinido é 0 |
| FaxEmail | Email para onde reencaminhar o fax |
| FaxRing | Por quantos segundos devemos escutar tons de fax? O padrão é 5 |
| Vm | Correio de voz ativado? Valores possíveis: 1 ou 0 |
| Vmring | Quantos segundos antes de o correio de voz entrar em ação |
| Vms2t | Transcrição de voz para texto do correio de voz (Voicemail Speech 2 Text) -- 1 para ativado, 0 para desativado |
| Vmemail | Endereço de e-mail para onde reencaminhar as mensagens de voicemail |
| Cnam | Ativar consultas CNAM (valores possíveis 0 ou 1 - padrão 0) |
| Record | Gravar as conversas telefônicas (0 ou 1, padrão 0) |
| Screening | Filtrar chamadores (pedir-lhes que se identifiquem antes de serem ligados - valores possíveis 0 ou 1, por predefinição 0 |
| Channels | De quantos canais precisamos? O valor predefinido é 2, a menos que o número tenha apenas 1 canal disponível. Tenha em atenção que, para números apenas SMS (números sem capacidade VoIP), esta definição não tem qualquer efeito, pelo que não a defina se não for necessária. |
| Atcd | Detecção Automática de Chamadas de Telemarketing -- recurso que detecta chamadas automatizadas/robôs e desliga se tal chamada for detectada. Valores possíveis 1 ou 0, padrão 0 |
| SID | ID da subconta (Sub Account ID) — defina as suas subcontas em https://www.multitel.net/auth/setting/ no separador Subcontas (SubAccounts) |
URL para GET:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... etc
Observe que os parâmetros usados para GET são exatamente os mesmos que os parâmetros usados para POST e devem ser usados na ordem exata em que estão listados em
a tabela acima.
Recomendamos fortemente que você use POST em vez de GET, pois isso minimiza o risco de trocar os parâmetros.