CNAM-integration
CNAM REST API-reference
Anmod om et opkaldernavn via HTTPS, og håndter resultat, gebyr og fejl.
Vælg opslagsadfærden
| Niveau | Offentlig pris pr. forespørgsel | Hvad det gør |
|---|---|---|
| Starter | 0,0026 US$ | Bruger proprietære og cachede oplysninger om opkaldernavne. |
| Standard | 0,0037 US$ | Foretager et netværksopslag i realtid for hver forespørgsel. |
| Mixed | 0,004 US$ | Forsøger først et opslag i realtid og falder derefter tilbage til data fra Starter, når der ikke findes noget navn. |
Den valgte tjeneste bestemmer opslagsadfærden; Mixed er ikke et opslag, der bruger cachen først. Gennemgå den takst, der er tildelt din konto, før produktionsbrug. Et opkaldernavn er ikke bevis på identitet eller ejerskab.
Send et autentificeret opslag
Endpoint: GET https://api.multitel.net/v3/cnam/NUMBER. Brug telefonnummeret i internationalt format inklusive landekode, med kun cifre og uden tegnsætning eller indledende plus. Udfør dette fra din applikationsserver med godkendte API-legitimationsoplysninger.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/cnam/12025550123"Angiv de to miljøvariabler via hemmelighedskonfiguration på serversiden. Et tildelt bearer-token er kun et alternativ, når denne adgang er aktiveret, og dets kilde-IP-begrænsninger er opfyldt. Læg aldrig en API-hemmelighed i en offentlig browser-bundle.
Læs JSON-svaret
Dette svar er illustrativt. Det returnerede navn og gebyret afhænger af opslaget og den valgte tjeneste.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"name": "EXAMPLE CALLER",
"cost": "0.004",
"balance": "24.9960"
}
}status.code- Applikationens resultatkode; normaliser streng-/numeriske værdier, før du sammenligner med 200.
status.msg- Den tilhørende resultat- eller afvisningsmeddelelse.
response.number- Det forespurgte nummer.
response.name- Det tilgængelige opkaldernavn.
response.cost- Det rapporterede gebyr for denne forespørgsel; behandl det som et decimalbeløb.
response.balance- Den rapporterede kontosaldo, når den er til stede.
Resultater uden navn og fejl
En vellykket forespørgsel garanterer ikke et brugbart opkaldernavn. Håndter et tomt navn, et nummer returneret i stedet for et navn og et afvist opslag. Applikationskode 403 kan betyde utilstrækkelig saldo, et forbudt køb eller et nummer uden resultat; kontroller meddelelsen.
Kontroller både HTTP-status og JSON-status, før du tilgår response.name. Svarobjektet kan mangle ved fejl. Et manglende navn bør ikke forhindre, at det almindelige opkald routes.
Fakturering, genforsøg og forskellen fra opdatering af opkalder-ID
Et nyt opslag kan medføre et forespørgselsgebyr. Disse opslagsgrænseflader dokumenterer ikke en idempotensnøgle, så et nyt genforsøg kan være en anden fakturerbar forespørgsel. Brug begrænset backoff ved transport-/servicefejl, løs kontofejl først, og afstem de rapporterede forespørgselsgebyrer. Brug kun cache i en periode, der passer til din applikation; opkaldernavne kan ændre sig.
Et CNAM-opslag læser et navn. Det ændrer ikke det navn, der vises på dine udgående opkald. En LIDB-opdatering af opkaldernavn er en separat operation med egne felter, autorisation, pris og behandling.