Ta funkcja umożliwia zakup numeru telefonu.
Jeśli wolisz proste rozwiązania, wystarczy zdefiniować domyślny identyfikator URI ringto (https://www.multitel.net/auth/setting , w zakładce „URI Settings” (ustawienia URI)), a następnie wywołać poniższy adres URL:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Pomyślne wywołanie zwróci następujący komunikat:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Nieudane wywołanie API zwróci jeden z następujących komunikatów:
{"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.Jeśli musisz określić więcej parametrów, czytaj dalej:
POST URL: https://api.multitel.net/json/buynumbers/
Parametry POST:
| UserName | Twoja nazwa użytkownika logowania lub nazwa użytkownika API |
| Password | Twoje hasło logowania lub hasło API |
| Number | Numer telefonu, który chcesz kupić |
| Description | Krótki opis (jeśli nie podano, domyślnie wartość Number) |
| Type | Odpowiednik „Cel przekierowania (Forward Destination)” z interfejsu internetowego. Możliwe wartości to: 1 (dla SIP) lub 2 (dla Dial) |
| RingType | 1 dla sekwencyjnego, 2 dla losowego, 3 dla jednoczesnego |
| Ringstyle | 1 – dzwonek, 2 – muzyka (Early Media) |
| URI | Pierwszy adres SIP URI do wywołania (lub numer telefonu do wybrania -- bez prefiksu 00/011/+) |
| URI2 | Drugi identyfikator SIP URI do dzwonienia |
| URI3 | Trzeci URI SIP, na który ma zostać skierowane połączenie |
| SMSRingType | 1 dla e-maila, 2 dla wysyłania żądaniem POST na adres URL |
| SMSURI | adres e-mail albo URL metody POST |
| FaxDetect | 1 – włączone, 0 – wyłączone. Jeśli nie podano, domyślnie 0 |
| FaxEmail | Adres e-mail, na który przekazywać faksy |
| FaxRing | Przez ile sekund nasłuchiwać sygnałów faksu? Wartość domyślna to 5 |
| Vm | Poczta głosowa włączona? Możliwe wartości: 1 lub 0 |
| Vmring | Po ilu sekundach włączy się poczta głosowa |
| Vms2t | Transkrypcja poczty głosowej (Voicemail Speech 2 Text) -- 1 = włączone, 0 = wyłączone |
| Vmemail | Adres e-mail, na który przekazywać wiadomości poczty głosowej |
| Cnam | Włącz wyszukiwanie CNAM (możliwe wartości 0 lub 1 – domyślnie 0) |
| Record | Nagrywaj rozmowy telefoniczne (0 lub 1, domyślnie 0) |
| Screening | Weryfikacja dzwoniących (prośba o przedstawienie się przed połączeniem – możliwe wartości 0 lub 1, domyślnie 0 |
| Channels | Ilu kanałów potrzebujemy? Domyślnie 2, chyba że numer ma dostępny tylko 1 kanał. Pamiętaj, że w przypadku numerów tylko SMS (numerów bez funkcji VoIP) to ustawienie nie ma wpływu, więc nie ustawiaj go, jeśli nie jest potrzebne. |
| Atcd | Automatyczne wykrywanie połączeń telemarketingowych -- funkcja, która nasłuchuje połączeń automatycznych lub robotycznych i rozłącza się, jeśli takie połączenie zostanie wykryte . Możliwe wartości 1 lub 0, domyślnie 0 |
| SID | Identyfikator subkonta (Sub Account ID) — zdefiniuj subkonta w https://www.multitel.net/auth/setting/ na karcie Subkonta (SubAccounts) |
Adres URL GET:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... itd.
Należy pamiętać, że parametry używane dla metody GET są dokładnie takie same jak parametry używane dla metody POST i należy ich używać dokładnie w kolejności, w jakiej zostały wymienione w
powyższa tabela.
Zdecydowanie zalecamy korzystanie z metody POST zamiast GET, ponieważ minimalizuje to ryzyko pomylenia parametrów.