Mit dieser Funktion können Sie eine Telefonnummer kaufen.
Wenn Sie es einfach halten möchten, müssen Sie nur einen Standard-ringto-URI (https://www.multitel.net/auth/setting , in der Registerkarte „URI Settings“ (URI-Einstellungen)) definieren und dann die untenstehende URL aufrufen:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Ein erfolgreicher Aufruf liefert die folgende Meldung zurück:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Ein erfolgloser API-Aufruf gibt eine der folgenden Meldungen zurück:
{"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.Wenn Sie weitere Parameter angeben müssen, lesen Sie weiter:
POST URL: https://api.multitel.net/json/buynumbers/
POST-Parameter:
| UserName | Ihr Login-Benutzername oder Ihr API-Benutzername |
| Password | Ihr Anmeldepasswort oder Ihr API-Passwort |
| Number | Die Telefonnummer, die Sie kaufen möchten |
| Description | Kurzbeschreibung (falls keine angegeben wird, wird der Wert des Feldes Number verwendet) |
| Type | Entspricht „Weiterleitungsziel (Forward Destination)“ in der Weboberfläche. Mögliche Werte sind: 1 (für SIP) oder 2 (für Dial) |
| RingType | 1 für Sequenziell, 2 für Zufällig, 3 für Gleichzeitig |
| Ringstyle | 1 für Rufton, 2 für Musik (Early Media) |
| URI | Erster SIP-URI, der klingeln soll (oder zu wählende Telefonnummer – bitte ohne 00/011/+-Präfix) |
| URI2 | Zweite anzurufende SIP-URI |
| URI3 | Dritte SIP-URI, an die der Anruf zugestellt werden soll |
| SMSRingType | 1 für E-Mail, 2 für eine POST-Anfrage an eine URL |
| SMSURI | entweder E-Mail-Adresse oder die POST-URL |
| FaxDetect | 1 für aktiviert, 0 für deaktiviert. Wenn nicht angegeben, ist der Standardwert 0 |
| FaxEmail | E-Mail-Adresse für die Faxweiterleitung |
| FaxRing | Wie viele Sekunden sollen wir auf Faxtöne hören? Standardwert ist 5 |
| Vm | VoiceMail aktiviert? Mögliche Werte: 1 oder 0 |
| Vmring | Nach wie vielen Sekunden die Voicemail anspringt |
| Vms2t | Voicemail-Transkription (Speech 2 Text) -- 1 = aktiviert, 0 = deaktiviert |
| Vmemail | E-Mail-Adresse, an die Voicemails weitergeleitet werden sollen |
| Cnam | CNAM-Abfragen aktivieren (mögliche Werte 0 oder 1 – Standard ist 0) |
| Record | Telefongespräche aufzeichnen (0 oder 1, Standard ist 0) |
| Screening | Anrufer prüfen (bitten Sie sie, sich zu identifizieren, bevor sie verbunden werden – mögliche Werte 0 oder 1, Standard ist 0 |
| Channels | Wie viele Kanäle benötigen wir? Standardmäßig 2, sofern für die Nummer nicht nur 1 Kanal verfügbar ist. Bitte beachten Sie, dass diese Einstellung bei reinen SMS-Nummern (Nummern ohne VoIP-Funktion) keine Wirkung hat; legen Sie sie daher nicht fest, wenn Sie sie nicht benötigen. |
| Atcd | Automatische Telemarketing-Anruferkennung – Funktion, die automatisierte/Robo-Anrufe erkennt und auflegt, wenn ein solcher Anruf erkannt wird. Mögliche Werte 1 oder 0, Standard ist 0 |
| SID | Unterkonto-ID (Sub Account ID) – definieren Sie Ihre Unterkonten unter https://www.multitel.net/auth/setting/ auf der Registerkarte Unterkonten (SubAccounts) |
GET-URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... etc
Bitte beachten Sie, dass die für GET verwendeten Parameter genau dieselben sind wie die für POST verwendeten Parameter und dass sie in genau der Reihenfolge verwendet werden sollten, in der sie aufgeführt sind in
die obige Tabelle.
Wir empfehlen dringend, POST statt GET zu verwenden, da dies das Risiko minimiert, Parameter zu vertauschen.