Zakoupení vybraného telefonního čísla

Vyberte číslo a cenu společně

Zakupte jedno konkrétní číslo vybrané z aktuálního vyhledávání dostupných čísel. Jako ID čísla použijte hodnotu vybrané položky info.uuid a jako ID ceny jednu z hodnot téže položky price[].uuid. Cesta přijímá také celé uložené číslo, ale ID země, oblasti ani předvolby nenahrazuje výběr čísla.

Vyhledávání ani načtení uložených cen číslo nerezervuje a nezaručuje neměnnost jeho ceny. Potvrďte vybraný zřizovací poplatek, měsíční cenu, sazbu za minutu příchozího hovoru, zahrnuté minuty a kanály i oprávnění účtu k nákupu a registrační požadavky. Počáteční základní částka v posuzované pomocné funkci je součtem zřizovacího poplatku a měsíční ceny; pro vybraný tarif je nutné potvrdit veškeré poplatky a podmínky konkrétního poskytovatele.

Odešlete požadavek na nákup s ochrannými kontrolami metodou POST

Použijte povolený účet API přes HTTPS z povolené zdrojové IP adresy. Následující příkaz provádí nákup, nikoli cenovou nabídku nebo zkušební běh. Všechny proměnné nastavte podle stejného aktuálního výběru čísla a ceny. Pole limitů zachovávají původní předponu restore_quote_; současný portál je používá také pro nákupy konkrétních čísel s ochrannými kontrolami.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode "restore_quote_price_id=$PRICE_ID" \
  --data-urlencode "restore_quote_setup=$SETUP_PRICE" \
  --data-urlencode "restore_quote_monthly=$MONTHLY_PRICE" \
  --data-urlencode "restore_quote_per_minute=$PER_MINUTE_PRICE" \
  --data-urlencode "restore_quote_channels=$CHANNELS" \
  "https://api.multitel.net/v3/rentnumber/$NUMBER_ID/$PRICE_ID"

Použijte formulářový požadavek POST podle ukázky. Pomocná funkce umí zpracovat také JSON a obalový objekt voleb, ale tato revize nepotvrdila úplnou shodu chování pro všechny větve zpracování cenových nabídek a poskytovatelů. K nákupu nepoužívejte GET, přestože tento starší koordinátor výslovně nekontroluje použitou metodu.

Kdykoli zadáte ID ceny z cenové nabídky, zadejte také všechna číselná pole nabídky. Změněné ID, cena nad limitem, chybějící či neplatný limit, změněný počet kanálů nebo obsazený zámek cenové nabídky vrátí kód API 409 ještě před odesláním požadavku vybranému poskytovateli pronájmu. Porovnání připouští malou toleranci čísel s plovoucí desetinnou čárkou; používejte skutečně zobrazené hodnoty tarifu, nikoli ručně zaokrouhlenou cenu.

Ochranné kontroly nemění celý postup ve zkušební běh ani transakci. Vyhledání registrace, zřízení identity nebo jiné úkony pomocné funkce mohou proběhnout před těmito kontrolami. Kontroly také nezaručují neměnnost externí nabídky čísel ani nenahrazují omezení nákupu na úrovni účtu.

Registrace a aktivace

Je-li to vyžadováno, přidejte formulářové pole RegistrationID obsahující UUID registračního profilu patřícího zákazníkovi. Nejde o ID nahraného dokladu, adresu dodavatele ani samostatnou entitu identity. Pomocná funkce vyhledá profil v rámci ověřeného účtu a odmítne chybějící nebo nedostupné profily.

U některých podporovaných nabídek čísel je nákup možný před dokončením registrace; u jiných je profil vyžadován již před nákupem. Nadále může být nutné ověření nebo zřízení specifické pro daného operátora. Úspěšný nákup ani vynechání úvodní kontroly nevykládejte jako výjimku z registrace nebo okamžitou aktivaci.

Pokud je v odpovědi přítomno pole registration_requirements, určuje strukturované vyhledání požadavků podle země a typu čísla. Ke splnění příslušných požadavků použijte registrační katalog a postup předkládání dokladů. Vrácený text ani metadata samy o sobě profil neschvalují.

Zabraňte nepozorované záměně tarifu

Starší koordinátor může odvodit nezadanou cenu z dat čísla v mezipaměti. Pokud výslovně zadané ID ceny již neexistuje, může také přejít na nejnovější cenu účtu pro předvolbu uloženou v mezipaměti a aktualizovat výběr povolené ceny v mezipaměti. Při výběru tarifu schváleného zákazníkem se na tato náhradní řešení nespoléhejte.

Zadejte výslovně vybranou cenu a odpovídající pole ochranných kontrol cenové nabídky. Kontrola ID cenové nabídky odmítne přechod na jiné ID před odesláním požadavku na pronájem. Po konfliktu kvůli neaktuální ceně obnovte vyhledávání a nechte nový výběr schválit; neodstraňujte ochranné kontroly, abyste nákup vynutili.

Pro všechny větve zpracování není zaručena doba rezervace ani jednotně vynucována doba platnosti mezipaměti. Dostupnost čísla, cenové limity účtu a pravidla nákupu se během postupu znovu kontrolují, úplné chování specifické pro jednotlivé poskytovatele však zůstává předmětem revize.

Pokročilé: výchozí nastavení směrování účtu

Nákup může převzít stávající hlasové cíle účtu, záložní cíle při selhání, cíl SMS a předvolbu propojovacího svazku pro příchozí provoz. Před objednáním tato výchozí nastavení zkontrolujte; vynechání voleb směrování nezaručuje číslo bez konfigurace. Posuzovaná pomocná funkce ve výchozím nastavení zapíná automatické obnovování.

Jde o význam a chování voleb sdílené pomocné funkce, nikoli o záruku, že každý dodavatel ukládá všechna volitelná nastavení stejně. Existují i další starší pole pro hlasové služby, hlasovou schránku, fax a SMS, která však stále vyžadují úplnou revizi pro jednotlivé poskytovatele. Než se začnete spoléhat na hovory nebo zprávy, ověřte uloženou konfiguraci zakoupeného čísla prostřednictvím postupu správy účtu.

Odpověď

Smyšlený příklad jednoduchého nákupu; hodnoty a funkce se liší podle vybraného tarifu.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "price": {
      "per_minute": "0.0100",
      "free_minutes": "100",
      "setup_price": "2.00",
      "monthly_price": "4.00",
      "channels": "2",
      "overflow": "0"
    },
    "features": [
      "voice"
    ],
    "needs_registration": 0,
    "registration_requirements": null
  }
}

Koordinátor používá vlastní status.code/status.msg a obálku response bez zaručeného pole status.results. Při chybě je seznam odpovědi obvykle prázdný. Při úspěchu zkontrolujte vrácené číslo a cenu a poté ověřte jejich soulad se seznamem čísel účtu a stavem registrace. Přijetí poskytovatelem není testem skutečného hlasového hovoru, SMS ani faxu.

Chyby a nejisté výsledky

Přečtěte si skutečné tělo odpovědi API i stav HTTP. Externí poskytovatel může přijmout pronájem předtím, než selže místní oznámení, registrace nebo jiné zpracování. Některá přidělení čísel z místní zásoby používají databázové transakce, neexistuje však univerzální vrácení objednávek u externích poskytovatelů zpět. Tento koordinátor neposkytuje klientský klíč idempotence.

Před opakováním ověřte skutečný stav

1. Před jednorázovým odesláním uložte schválené číslo, cenu a limity cenové nabídky do záznamu objednávky ve své aplikaci.
2. Po požadavku načtěte seznam zakoupených čísel a podrobnosti čísla pro tentýž účet, a to i po vypršení časového limitu nebo chybě.
3. Pokud číslo existuje, ověřte jeho cenu, obnovování, směrování a stav registrace místo odeslání dalšího požadavku na nákup.
4. Pokud je výsledek stále nejistý, nechte před opakováním podporu ověřit soulad objednávky u poskytovatele a účtování na účtu. Samotná chybová zpráva nebo příznak úspěchu ve starším protokolu není dostatečným důkazem.
5. Po potvrzení vlastnictví a aktivace proveďte obvyklé kontroly směrování a testy služeb v rámci účtu.