Zvolte podporovanou předvolbu
Použijte aktuální jednotlivou mobilní předvolbu ze zjišťování. Tento koncový bod je určen pro ústředny NANPA: NPA označuje směrové číslo oblasti a NXX označuje ústřednu. Předvolba pouze se směrovým číslem oblasti je příliš široká. Neposílejte seskupené identifikátory zobrazení a nevyvozujte podporu jiné země z toho, že její předvolba obsahuje dost číslic.
Použijte počet jako nápovědu
Přečtěte si response.count, spolu s response.npa a response.nxx označujícími ústřednu. Jde o snímek služby pokrytí, nikoli zásoby držené pro váš účet. Před objednáním potvrďte skutečná čísla, platné cenové nabídky a případné registrační požadavky. Úspěšný počet nikdy neopravňuje k nákupu.
Rozlišujte nulové zásoby od nezdařeného vyhledávání
Úspěšný počet nula se liší od chyby API. Zkontrolujte status.code a status.msg a také stav HTTP. Považujte vypršení časového limitu nebo nezdařené vyhledávání za neznámou dostupnost a opakujte později s prodlevou mezi pokusy (backoff).
Požadavek
Používejte přihlašovací údaje svého povoleného účtu API přes HTTPS. Je podporováno ověřování Basic a nosičové tokeny (bearer) povolených účtů API; platí omezení účtu.
GET s identifikátorem předvolby v cestě URL. Nejsou zdokumentovány žádné parametry dotazu ani těla.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Název | Typ | Povinný | Popis |
|---|---|---|---|
prefix_id | string | Ano | Zkopírujte jednotlivý identifikátor předvolby z odpovědi zjišťování. Použijte podporovanou mobilní předvolbu NANPA obsahující směrové číslo oblasti (NPA) a ústřednu (NXX), nikoli identifikátor pouze se směrovým číslem oblasti nebo seskupený souhrnný identifikátor. Zacházejte s identifikátorem jako s neprůhlednou hodnotou. |
Odpověď
Zkontrolujte status.code v těle JSON i stav HTTP. Úspěšná response má status.code 200 a status.msg Results. response je objekt, nikoli seznam: count je celočíselný snímek zásob; npa a nxx jsou tříznakové řetězce. status.results není u tohoto asociativního objektu přítomno. Počet 0 znamená, že vyhledávání pokrytí nenašlo odpovídající ústřednu nebo vrátilo nulové zásoby; nedokazuje, že všichni dodavatelé ani jiné cesty zjišťování nemají žádná čísla.
Ilustrativní tvar odpovědi; nejde o živá data účtu ani o aktuální cenovou nabídku.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Chyby
- 404: Poskytovatel zakázán: pokrytí mobilních zásob není ve službě k dispozici.
- 404: Neplatný identifikátor předvolby: získejte aktuální jednotlivý identifikátor předvolby ze zjišťování.
- 404: Neplatná předvolba: uložená předvolba neobsahuje dost číslic pro vyhledávání NPA/NXX.
- 500: Pokrytí zásob se nezdařilo: nadřazené vyhledávání nevrátilo úspěšný výsledek pokrytí. Opakujte později s prodlevou mezi pokusy (backoff); nezdaření neznamená počet zásob nula.
Dostupnost a vedlejší účinky
- Operace kontroluje zásoby a nevytváří objednávku, nerezervuje čísla ani neodečítá kupní částku.
- Zásoby se mohou okamžitě změnit. Počet pokrytí není upravován tak, aby sliboval nakupitelnost specifickou pro účet nebo stejnou délku jako odpověď dalšího vyhledávání čísel.
- Vyhledávání kontaktuje službu pokrytí a může chvíli trvat. Neprovádějte opakovaně dotaz na každou předvolbu a nepovažujte vypršení časového limitu/chybu za úspěšné nulové zásoby.