Cette fonction vous permet d'acheter un numéro de téléphone.
Pour simplifier la configuration, définissez une URI de destination par défaut (ringto) (https://www.multitel.net/auth/setting, dans l’onglet « URI Settings »), puis appelez l’URL ci-dessous :
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Un appel API réussi renvoie le message suivant :
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Un appel à l’API qui échoue renverra l’un des messages suivants :
{"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 vous devez spécifier plus de paramètres, lisez la suite :
URL POST : https://api.multitel.net/json/buynumbers/
Paramètres POST :
| UserName | Votre nom d'utilisateur de connexion ou votre nom d'utilisateur API |
| Password | Votre mot de passe de connexion ou votre mot de passe API |
| Number | Le numéro de téléphone que vous souhaitez acheter |
| Description | Description courte (si aucune n'est fournie, le numéro est utilisé par défaut) |
| Type | Équivalent à « Destination de transfert (Forward Destination) » de l'interface web. Valeurs possibles : 1 (pour SIP) ou 2 (pour Dial) |
| RingType | 1 pour Séquentiel, 2 pour Aléatoire, 3 pour Simultané |
| Ringstyle | 1 pour la sonnerie, 2 pour la musique avant réponse (Early Media) |
| URI | Premier URI SIP à faire sonner (ou numéro de téléphone à composer -- sans préfixe 00/011/+, s'il vous plaît) |
| URI2 | Deuxième URI SIP à faire sonner |
| URI3 | Troisième URI SIP vers laquelle envoyer l’appel |
| SMSRingType | 1 pour e-mail, 2 pour un envoi par POST vers une URL |
| SMSURI | soit l’adresse e-mail, soit l’URL POST |
| FaxDetect | 1 pour activé, 0 pour désactivé. Si non spécifié, la valeur par défaut est 0 |
| FaxEmail | E-mail où transférer le fax |
| FaxRing | Combien de secondes devons-nous écouter les tonalités de fax ? La valeur par défaut est 5 |
| Vm | Messagerie vocale activée ? Valeurs possibles 1 ou 0 |
| Vmring | Nombre de secondes avant l'activation de la messagerie vocale |
| Vms2t | Transcription de la messagerie vocale (Speech 2 Text) -- 1 pour activé, 0 pour désactivé |
| Vmemail | Adresse e-mail vers laquelle transférer les messages vocaux |
| Cnam | Activer les recherches CNAM (valeurs possibles 0 ou 1 - valeur par défaut : 0) |
| Record | Enregistrer les conversations téléphoniques (0 ou 1, par défaut 0) |
| Screening | Filtrer les appelants (leur demander de s’identifier avant d’être mis en relation - valeurs possibles : 0 ou 1, valeur par défaut : 0 |
| Channels | De combien de canaux avons-nous besoin ? La valeur par défaut est 2, sauf si le numéro ne dispose que de 1 seul canal. Veuillez noter que pour les numéros SMS uniquement (numéros sans capacité VoIP), ce paramètre n'a aucun effet, ne le définissez donc pas si vous n'en aurez pas besoin. |
| Atcd | Détection automatique des appels de télémarketing -- fonctionnalité qui détecte les appels automatisés ou robotisés et raccroche si un tel appel est détecté. Valeurs possibles 1 ou 0, valeur par défaut 0 |
| SID | Identifiant du sous-compte (Sub Account ID) — définissez vos sous-comptes sur https://www.multitel.net/auth/setting/ dans l'onglet Sous-comptes (SubAccounts) |
URL GET :
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... etc
Veuillez noter que les paramètres utilisés pour GET sont exactement les mêmes que ceux utilisés pour POST et qu'ils doivent être utilisés exactement dans l'ordre dans lequel ils sont listés dans
le tableau ci-dessus.
Nous vous recommandons vivement d'utiliser POST plutôt que GET, car cela minimise le risque d'inverser les paramètres.