Hívó nevének lekérdezése

Kérdezze le egy telefonszámhoz az elérhető hívónevet. Ez éles lekérdezés, amely megterhelheti a fiókját akkor is, ha az eredmény a szolgáltatás gyorsítótárából származik. Nem módosítja a saját tulajdonú telefonszámáról indított hívásoknál megjelenő nevet.

A visszaadott név nem igazolja a személyazonosságot, a tulajdonjogot vagy a hívásra való jogosultságot. A név hiányozhat, lehet elavult, rövidített vagy földrajzi megjelölés, illetve helyette maga a telefonszám is megjelenhet.

Kérés

Az engedélyezett API-fiókját a hozzá engedélyezett forrás-IP-címről használja. A hitelesítő adatokat szerveroldali titoktárolóban tartsa. A példa környezeti változókat és egy kitalált észak-amerikai telefonszámot használ; ne helyezzen hitelesítő adatokat URL-ekbe vagy nyilvános böngészőoldali kódba.

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

A teljes telefonszámot számjegyekkel, az országhívóval együtt adja meg; Észak-Amerika esetén például tizenegy számjegyet, 1 kezdő számjeggyel. Ne hagyatkozzon arra, hogy a kéréskezelő normalizálja az írásjeleket vagy a pluszjelet. Nincs szükség kéréstörzsre vagy régióválasztóra. A tervezett felhasználáshoz támogatott lefedettséget egyeztesse a MultiTEL-lel.

Válasz

Az értékek csak szemléltető jellegűek; a költség nem árajánlat.

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

A hívónév-lekérdezés mezői
Mező	Jelentés
number	A lekérdezett telefonszám.
name	Az elérhető név vagy a helyettesítő szöveg. Nem jelent személyazonosság-ellenőrzést.
cost	Az ezen végrehajtási ág által közölt, a fiókhoz vagy szolgáltatáshoz beállított lekérdezési díj. A szemléltető érték helyett a fiók aktuális díjszabását vegye alapul.
balance	A válaszhoz kiszámított egyenleg. Nem a fiók egyenlegének friss, tranzakciós lekérdezése.

Díjak és egyeztetés

A nevet tartalmazó eredményekért a fiókhoz beállított CNAM-díjat számítják fel. Az ismételt vagy gyorsítótárból kiszolgált lekérdezés újabb díjat eredményezhet; a felület nem biztosít idempotenciakulcsot. Az automatikus lekérdezések engedélyezése előtt ellenőrizze a fiók aktuális díjszabását.

A gyorsítótárban tárolt üres névnél a válasznak ismert korlátja van: a kéréskezelő 200 értékű API-kódot adhat vissza üres névvel, nem nulla költséggel és csökkentett számított egyenleggel akkor is, ha az adott végrehajtási ág nem terheli meg a fiókot. Ezt a választ önmagában ne tekintse a díj felszámítását igazoló bizonyítéknak. Egyeztesse az eredményt a fiók számlázási nyilvántartásával és egy friss egyenleglekérdezéssel, és nem egyértelmű eredmények esetén forduljon az ügyfélszolgálathoz.

Az előre fizetett egyenleg ellenőrzése jelenleg legalább 0.004 egyenleget követel meg a lekérdezés előtt, a beállított lekérdezésenkénti díjtól függetlenül. A rendszer azokat a fiókokat is elutasítja, amelyeknél a vásárlások le vannak tiltva. Ezek az ellenőrzések nem teszik ezt a végpontot árajánlatot adó vagy költési korlátot kezelő API-vá.

Hibák és újrapróbálkozások

Ellenőrizze a HTTP-állapotot és a JSON status.code/status.msg mezőit is. A 403 értékű API-kód elégtelen előre fizetett egyenleget, tiltott vásárlásokat, a fiók jogosultsági problémáját vagy azt is jelentheti, hogy nem található hívónév. A név nélküli végrehajtási ág karakterláncként is visszaadhatja a kódot. Vizsgálja meg az üzenetet ahelyett, hogy minden 403 kódot hibás hitelesítő adatokként értelmezne. A konfigurációs ütközések 500 értékű API-kódot eredményezhetnek.

Díjköteles lekérdezés után is bekövetkezhet időtúllépés. Csak akkor alkalmazzon korlátozott számú, növekvő várakozási idejű újrapróbálkozást, ha ez megfelel az alkalmazásának, és előbb tisztázza a bizonytalan kimenetelű kísérletek elszámolását. Elutasított telefonszám, illetve fiókjogosultsági vagy egyenleghiba esetén ne próbálkozzon újra ismételten. A saját alkalmazásában használt válaszgyorsítótár csökkentheti az ismételt kérések számát, a szerződésében foglaltak és a pontossági követelmények figyelembevételével.

Egyéb telefonszám-műveletek

Ez az olvasási művelet elkülönül a kimenő hívónév/LIDB frissítésétől, a telefonkönyvi bejegyzéstől és a hívó regisztrációjától. Ezekhez a műveletekhez külön kötelező mezők, jogosultságok és díjak tartoznak. Használja a következő funkciókat: kiosztási lefedettség az előhívótábla ellenőrzésére, vagy telefonszám-keresés a megrendelhető számkészlet lekérdezésére. Ezek egyike sem igazolja, hogy a hívó valóban az, akinek mondja magát.