Slå en opkalders navn op
Hent et tilgængeligt opkaldernavn for et telefonnummer. Dette opslag foretages i produktionsmiljøet og kan medføre en debitering af din konto, også når resultatet kommer fra tjenestens cache. Det ændrer ikke det navn, der vises ved udgående opkald fra et nummer, du ejer.
Et returneret navn er ikke en bekræftelse af identitet, ejerskab eller tilladelse til at ringe. Navne kan mangle, være forældede eller forkortede, være geografiske betegnelser eller være erstattet af et telefonnummer.
Anmodning
Brug din aktiverede API-konto fra dens tilladte kilde-IP-adresse. Opbevar legitimationsoplysninger i et hemmelighedslager på serversiden. Eksemplet bruger miljøvariabler og et fiktivt nordamerikansk nummer; anbring ikke legitimationsoplysninger i URL'er eller offentligt tilgængelig browserkode.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cnam/12025550123Angiv hele nummeret som cifre inklusive landekoden, for eksempel elleve cifre begyndende med 1 for Nordamerika. Regn ikke med, at behandlingsfunktionen normaliserer tegnsætning eller et plustegn. Der kræves hverken en anmodningskrop eller et regionsvalg. Få MultiTEL til at bekræfte den understøttede dækning til dit planlagte formål.
Svar
Værdierne er kun eksempler; omkostningen er ikke et pristilbud.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"name": "EXAMPLE NAME",
"cost": 0.0037,
"balance": 9.9963
}
}| Felt | Betydning |
|---|---|
| number | Det nummer, der blev anmodet om. |
| name | Det tilgængelige navn eller den tekst, der bruges som erstatning. Det er ikke identitetsbekræftelse. |
| cost | Den konfigurerede opslagspris for kontoen/tjenesten, som dette behandlingsforløb rapporterer. Brug kontoens aktuelle takst, ikke eksempelværdien. |
| balance | Den saldo, der er beregnet til svaret. Det er ikke en ny transaktionel forespørgsel om kontosaldoen. |
Debiteringer og afstemning
Resultater med et navn debiteres til kontoens konfigurerede CNAM-pris. Et gentaget opslag eller et opslag fra cachen kan medføre endnu en debitering; der stilles ingen idempotensnøgle til rådighed. Kontrollér kontoens aktuelle takst, før du aktiverer automatiske opslag.
Der er en kendt begrænsning i svaret ved et tomt navn i cachen: behandlingsfunktionen kan returnere API-kode 200 med et tomt navn, en omkostning forskellig fra nul og en reduceret beregnet saldo, selvom denne forgrening ikke debiterer kontoen. Betragt ikke dette svar alene som bevis på en debitering. Afstem med kontoens faktureringsoplysninger og et nyt saldoopslag, og kontakt support ved tvetydige resultater.
Kontrollen af forudbetalt saldo kræver i øjeblikket en saldo på mindst 0.004 før opslaget, uafhængigt af den konfigurerede pris pr. forespørgsel. En konto, hvor køb er deaktiveret, afvises også. Disse kontroller gør ikke dette slutpunkt til en API til pristilbud eller forbrugsgrænser.
Fejl og gentagne forsøg
Kontrollér både HTTP-status og JSON-felterne status.code/status.msg. API-kode 403 kan betyde utilstrækkelig forudbetalt saldo, forbud mod køb, et problem med kontoadgang eller at der ikke blev fundet et opkaldernavn. Behandlingsforløbet uden navn kan returnere koden som en tekststreng. Undersøg meddelelsen i stedet for at betragte enhver 403 som ugyldige legitimationsoplysninger. Konfigurationskonflikter kan returnere API-kode 500.
En timeout kan opstå efter et fakturerbart opslag. Brug kun et begrænset antal gentagne forsøg med stigende ventetid, når det passer til din applikation, og afstem først forsøg med usikkert udfald. Gentag ikke forsøg igen og igen for et afvist nummer eller ved fejl vedrørende kontotilladelser eller saldo. En svarcache i din egen applikation kan reducere gentagne anmodninger, under hensyntagen til din aftale og dine krav til nøjagtighed.
Andre nummerhandlinger
Denne læsehandling er adskilt fra en opdatering af navnet ved udgående opkald/LIDB, en optagelse i en telefonbog eller en registrering af en opkalder. Disse handlinger har deres egne påkrævede felter, adgangskrav og gebyrer. Brug tildelingsdækning til at kontrollere præfikstabellen eller nummersøgning til at finde numre, der kan bestilles. Ingen af disse handlinger bekræfter, at en opkalder er den, vedkommende udgiver sig for at være.