Vyhledání jména volajícího

Vyhledání jména volajícího

Získejte dostupný výsledek vyhledání jména volajícího pro telefonní číslo. Jde o vyhledání v produkčním prostředí, které může být účtováno na váš účet, i když výsledek pochází z mezipaměti služby. Nemění jméno zobrazované při odchozích hovorech z čísla, které vlastníte.

Vrácené jméno není ověřením totožnosti, vlastnictví ani oprávněním k volání. Jména mohou chybět, být zastaralá či zkrácená nebo mohou představovat zeměpisná označení či náhradní hodnotu v podobě telefonního čísla.

Požadavek

Použijte svůj aktivovaný účet API z jeho povolené zdrojové IP adresy. Přihlašovací údaje uchovávejte v úložišti tajných údajů na straně serveru. Příklad používá proměnné prostředí a smyšlené severoamerické číslo; nevkládejte přihlašovací údaje do adres URL ani do veřejně přístupného kódu prohlížeče.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/cnam/12025550123

Zadejte celé číslo pouze číslicemi včetně mezinárodní předvolby, například jedenáct číslic začínajících číslicí 1 pro Severní Ameriku. Nespoléhejte na to, že obslužná funkce normalizuje interpunkční znaménka nebo znaménko plus. Není vyžadováno tělo požadavku ani výběr oblasti. Ověřte si u společnosti MultiTEL podporované pokrytí pro zamýšlené použití.

Odpověď

Hodnoty jsou pouze ilustrativní; uvedená cena není cenovou nabídkou.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE NAME",
    "cost": 0.0037,
    "balance": 9.9963
  }
}

Účtování a kontrola vyúčtování

Výsledky obsahující jméno se účtují podle ceny CNAM nastavené pro účet. Opakované vyhledání nebo vyhledání z mezipaměti může vést k dalšímu poplatku; klíč idempotence není k dispozici. Před zapnutím automatických vyhledávání ověřte aktuální sazbu účtu.

U prázdného jména v mezipaměti existuje známé omezení odpovědi: obslužná funkce může vrátit kód API 200 s prázdným jménem, nenulovou cenou a sníženým vypočteným zůstatkem, přestože tato větev zpracování z účtu nic nestrhává. Samotnou takovou odpověď nepovažujte za důkaz naúčtování. Porovnejte ji se záznamy vyúčtování účtu a s novým dotazem na zůstatek, a v případě nejasných výsledků kontaktujte podporu.

Kontrola předplaceného kreditu v současnosti vyžaduje před vyhledáním zůstatek alespoň 0.004, nezávisle na nastavené ceně za dotaz. Odmítnut je také účet se zakázanými nákupy. Tyto kontroly z tohoto koncového bodu nedělají API pro cenové nabídky ani pro omezení útraty.

Chyby a opakované pokusy

Kontrolujte jak stav HTTP, tak status.code/status.msg v JSON. Kód API 403 může znamenat nedostatečný předplacený kredit, zakázané nákupy, problém s oprávněním účtu nebo nenalezené jméno volajícího. Postup pro nenalezené jméno může vrátit kód jako řetězec. Přečtěte si zprávu a nepovažujte každý kód 403 za nesprávné přihlašovací údaje. Konflikty konfigurace mohou vrátit kód API 500.

K vypršení časového limitu může dojít až po zpoplatněném vyhledání. Omezený počet opakovaných pokusů s prodlužujícími se prodlevami používejte pouze tehdy, pokud je to pro vaši aplikaci vhodné, a nejprve ověřte vyúčtování pokusů s nejistým výsledkem. Neopakujte stále dokola požadavky pro odmítnuté číslo ani po selhání kvůli oprávnění účtu nebo zůstatku. Mezipaměť odpovědí ve vaší vlastní aplikaci může omezit opakované požadavky, pokud to dovoluje vaše smlouva a požadavky na přesnost.

Další operace s čísly

Tato operace čtení je oddělená od aktualizace jména pro odchozí hovory či LIDB, zápisu do telefonního seznamu nebo registrace volajícího. Tyto operace mají vlastní povinná pole, požadavky na oprávnění a poplatky. Použijte pokrytí přidělených čísel ke kontrole tabulky předvoleb nebo vyhledávání čísel k vyhledání čísel dostupných k objednání. Žádná z těchto operací neprokazuje, že volající je tím, za koho se vydává.