CNAM-integráció
CNAM REST API referencia
Kérjen le hívónevet HTTPS-en keresztül, és kezelje az eredményt, a díjat és a hibákat.
Válassza ki a keresés működését
| Szint | Nyilvános ár lekérdezésenként | Mit csinál |
|---|---|---|
| Starter | 0,0026 USD | Saját tulajdonú és gyorsítótárazott hívónév-információkat használ. |
| Standard | 0,0037 USD | Minden lekérdezéshez valós idejű hálózati keresést végez. |
| Mixed | 0,004 USD | Először valós idejű keresést próbál, majd ha nem talál nevet, a(z) Starter adataira tér vissza. |
A lekérdezés működését a kiválasztott szolgáltatás határozza meg; a(z) Mixed nem a gyorsítótárat ellenőrzi először. Éles használat előtt ellenőrizze a fiókjához rendelt díjat. A hívónév nem bizonyítja a személyazonosságot vagy a tulajdonjogot.
Hitelesített keresés küldése
Végpont: GET https://api.multitel.net/v3/cnam/NUMBER. A nemzetközi számot csak számjegyekkel, országkóddal együtt adja meg, írásjelek és kezdő pluszjel nélkül. A kérést az alkalmazásszerveréről hajtsa végre, jóváhagyott API-hitelesítő adatokkal.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/cnam/12025550123"A két környezeti változót szerveroldali titokkonfiguráción keresztül adja meg. A kiosztott bearer hitelesítő adat csak akkor alternatíva, ha ez a hozzáférés engedélyezett, és a forrás-IP-korlátozásai teljesülnek. Soha ne tegyen API-titkot nyilvános böngészős csomagba.
A JSON-válasz olvasása
Ez a válasz szemléltető jellegű. A visszaadott név és a díj a kereséstől és a kiválasztott szolgáltatástól függ.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"name": "EXAMPLE CALLER",
"cost": "0.004",
"balance": "24.9960"
}
}status.code- Alkalmazás-eredménykód; a 200-zal való összehasonlítás előtt normalizálja a szöveges/numerikus értékeket.
status.msg- A hozzá tartozó eredmény- vagy elutasítási üzenet.
response.number- A lekérdezett szám.
response.name- Az elérhető hívónév.
response.cost- Az ehhez a lekérdezéshez jelentett díj; kezelje decimális összegként.
response.balance- A jelentett fiókegyenleg, ha jelen van.
Név nélküli eredmények és hibák
A sikeres kérés nem garantál használható hívónevet. Kezelje az üres nevet, a név helyett visszaadott számot és az elutasított keresést. A 403-as alkalmazáskód jelezhet elégtelen egyenleget, tiltott vásárlást vagy eredmény nélküli számot; vizsgálja meg az üzenetet.
A(z) response.name elérése előtt ellenőrizze mind a HTTP-állapotot, mind a JSON status mezőt. A válaszobjektum hiba esetén hiányozhat. A hiányzó név nem akadályozhatja a normál hívás irányítását.
Számlázás, újrapróbálkozások és a különbség a hívóazonosító frissítésétől
Egy új lekérdezés díjköteles lehet. Ezek a lekérdezési felületek nem dokumentálnak idempotenciakulcsot, ezért egy újabb próbálkozás második díjköteles lekérdezést eredményezhet. Átviteli vagy szolgáltatási hibánál korlátozott számú, várakozással elválasztott újrapróbálkozást használjon; előbb rendezze a fiókhibákat, és egyeztesse a jelentett lekérdezési díjakat. Csak az alkalmazásnak megfelelő ideig gyorsítótárazzon; a hívónév-adatok változhatnak.
A CNAM-keresés egy nevet olvas le. Nem változtatja meg a kimenő hívásain megjelenített nevet. A LIDB hívónév-frissítés külön művelet, saját mezőkkel, engedélyezéssel, árral és feldolgozással.