Najděte dostupná mobilní čísla

Potvrďte, že mobilní inventář je povolen

Toto vyhledávání používejte až po povolení inventáře mobilních čísel pro váš zákaznický účet. Získejte aktuální jednotlivou mobilní předvolbu prostřednictvím pracovního postupu objevování účtu. Podporovaná cesta vyžaduje bezdrátový inventář pro tuto předvolbu. Nezávisí na odpovídajícím záznamu směrovacích metadat pevné linky. Pokud si nejste jisti, zda je váš účet nebo předvolba povolena, kontaktujte podporu.

Současná starší (legacy) trasa spolehlivě neodmítá každý nezpůsobilý požadavek. Účet bez povoleného mobilního inventáře může obdržet běžný inventář, přestože odpověď stále uvádí info.is_mobile: 1 . Bezplatná (toll-free) předvolba může s tímto označením dosáhnout také větve bezplatného inventáře. Neurčujte mobilní službu pouze podle tohoto označení a neposílejte na tento koncový bod běžné ani bezplatné předvolby. Používejte potvrzený mobilní katalog účtu a povolený pracovní postup.

Ponechte každé číslo s jeho vlastním výběrem ceny

Pro každého kandidáta ponechte number, info.uuid a seznam price téhož záznamu pohromadě. Odpověď také obsahuje metadata předvolby/oblasti/země, smluvní podmínky a omezení registrace. Kandidáti jsou řazeni vzestupně podle měsíční ceny své první cenové volby; pro stejné ceny není zaručeno stabilní pořadí. Nenahrazujte vrácené ID čísla ID oblasti nebo předvolby ani je nespárujte s cenovým ID jiného kandidáta.

Úplná odpověď může obsahovat další pole metadat a cen. Vrácené features, hodnoty kanálů a restrictions popisují kandidáta; nezaručují, že volání, SMS, MMS nebo fax jsou již použitelné. Oprávnění účtu, registrace a vybraný tarif služby se stále uplatňují. Nezacházejte se zástupnými symboly příkladu jako s platnými ID nebo cenami.

Použijte malé kladné množství

Začněte množstvím 1. Normální požadavek poskytovatele normalizuje nekladné množství na 1 a omezuje hodnotu upstream na 300, ale pozdější zpracování výsledků stále používá původní vstup. Nulové množství proto může vyžádat upstream inventář a nevrátit žádné kandidáty. Jiné starší větve nedůsledně vynucují požadovaný počet výsledků. Nespoléhejte se na jediné univerzální maximum a neposílejte záporné, zlomkové nebo nečíselné hodnoty. Pro tuto trasu není zdokumentován žádný podporovaný veřejný vyhledávací filtr ani parametr těla s cenovým ID.

Rozlište nedostatek zásob od selhání vyhledávání

Odpověď 404 může představovat nedostupný inventář, zakázanou službu, selhané vyhledávání dodavatele nebo neplatné katalogové záznamy. Považujte časový limit nebo selhání poskytovatele za neznámou dostupnost, nikoli za potvrzené nulové zásoby. V případě potřeby obnovte výběr a opakujte s prodlevou mezi pokusy (backoff). Vyhněte se opakovanému dotazování každé telefonní ústředny. Samostatný koncový bod počtu mobilního inventáře je jen orientační snímek a nemusí odpovídat délce seznamu kandidátů tohoto účtu.

Před nákupem znovu zkontrolujte

Vyhledávání nerezervuje zásoby. Posuzovaná větev se snaží vyloučit již zakoupená čísla, ale selhané místní vyhledávání rezervace může takového kandidáta ve výsledku ponechat. Dostupnost, vlastnictví, schválené ceny a registraci musí zkontrolovat pracovní postup nákupu. Použijte čerstvý výběr s chráněným nákupním požadavkem a po jakémkoli nejistém výsledku nákupu před opakováním slaďte inventář účtu. Nikdy nenakupujte pouze proto, že byl vrácen kandidát.

Požadavek

Používejte povolený API účet přes HTTPS z povolené zdrojové IP adresy. Mobilní inventář musí být také povolen pro zákaznický účet; samotná autentifikace API to nepovolí.

GET s aktuálním identifikátorem jednotlivé předvolby a kladným celočíselným množstvím v cestě URL. Množství má při vynechání výchozí hodnotu 1. Použijte příklad s hodnotou 1; tato trasa neověřuje ani nevynucuje důsledně univerzální limit výsledků.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"

Odpověď

Zkontrolujte status.code a status.msg v těle JSON i stav HTTP. Při úspěchu je response seznam kandidátů čísel, status.msg je Results: následované počtem vrácených záznamů a status.results je serializovaná délka seznamu. Ceny kandidátů jsou specifické pro účet. Ilustrativní zkrácený příklad používá zástupné symboly namísto skutečného inventáře nebo cenové nabídky. Čísla obsahují kód země bez znaménka plus; identifikátory jsou neprůhledné řetězce.

Ilustrativní tvar odpovědi; nejde o živá data účtu ani aktuální nabídku.

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "info": {
        "uuid": "NUMBER_ID",
        "prefix_uuid": "PREFIX_ID",
        "country_iso": "US",
        "is_mobile": 1
      },
      "price": [
        {
          "uuid": "PRICE_ID",
          "monthly_price": "ACCOUNT_MONTHLY_PRICE",
          "setup_price": "ACCOUNT_SETUP_PRICE",
          "per_minute": "ACCOUNT_INCOMING_RATE",
          "channels": "PLAN_CHANNELS"
        }
      ],
      "features": [
        "voice",
        "sms",
        "mms",
        "t38"
      ]
    }
  ]
}

Chyby

• 404: Neplatné ID předvolby, země nebo oblasti: obnovte výběr jednotlivé mobilní předvolby.
• 404: Nenalezena žádná čísla: může to znamenat žádné použitelné zásoby, zakázanou službu, selhané vyhledávání poskytovatele, nepodporovaný výběr nebo omezení účtu. Není to důkaz autoritativního nulového počtu inventáře.

Dostupnost a vedlejší účinky

• Vyhledávání nepronajímá ani nerezervuje číslo a posuzovaná cesta neodečítá částku nákupu. Kontaktuje poskytovatele inventáře a může chvíli trvat.
• Úspěšná vyhledávání zapisují položky mezipaměti čísel a cen související s účtem a protokoly dotazů. Opakování vyhledávání není rezervace, uzamčení ceny ani nákup.
• Vrácené ceny, podmínky, omezení a schopnosti musí být posouzeny pro vybraný účet a číslo. Označení funkce nezakládá aktivaci, schválení zasílání zpráv ani testovanou funkčnost služby.