CNAM-integrasjon
Referanse for CNAM REST API
Be om et anropernavn over HTTPS og håndter resultat, kostnad og feil.
Velg oppslagsatferd
| Nivå | Offentlig pris per spørring | Hva det gjør |
|---|---|---|
| Starter | 0,0026 USD | Bruker proprietær og bufret anropernavninformasjon. |
| Standard | 0,0037 USD | Utfører et sanntidsoppslag i nettverket for hver spørring. |
| Mixed | 0,004 USD | Prøver først et sanntidsoppslag, og faller deretter tilbake til data fra Starter når det ikke finnes noe navn. |
Den valgte tjenesten avgjør oppslagsatferden; Mixed er ikke et oppslag som bruker hurtigbuffer først. Gå gjennom satsen som er tildelt kontoen din før produksjonsbruk. Et anropernavn er ikke bevis på identitet eller eierskap.
Send et autentisert oppslag
Endepunkt: GET https://api.multitel.net/v3/cnam/NUMBER. Oppgi telefonnumre i internasjonalt format med bare sifre og inkludert landskode, uten skilletegn eller innledende pluss. Kjør dette fra applikasjonsserveren din med godkjent API-legitimasjon.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/cnam/12025550123"Oppgi de to miljøvariablene gjennom hemmelighetskonfigurasjon på serversiden. En tildelt bearer-legitimasjon er et alternativ bare når denne tilgangen er aktivert og begrensningene for kilde-IP er oppfylt. Legg aldri en API-hemmelighet i en offentlig nettleserbunt.
Les JSON-svaret
Dette svaret er illustrerende. Det returnerte navnet og kostnaden avhenger av oppslaget og den valgte tjenesten.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"name": "EXAMPLE CALLER",
"cost": "0.004",
"balance": "24.9960"
}
}status.code- Applikasjonens resultatkode; normaliser streng-/numeriske verdier før sammenligning med 200.
status.msg- Den tilhørende resultat- eller avvisningsmeldingen.
response.number- Nummeret det ble spurt om.
response.name- Det tilgjengelige anropernavnet.
response.cost- Kostnaden som er rapportert for denne spørringen; behandle den som et desimalbeløp.
response.balance- Den rapporterte kontosaldoen, når den finnes.
Resultater uten navn og feil
En vellykket forespørsel garanterer ikke et nyttig anropernavn. Håndter et tomt navn, et nummer returnert i stedet for et navn og et avvist oppslag. Applikasjonskode 403 kan beskrive utilstrekkelig saldo, et forbudt kjøp eller et nummer uten resultat; les meldingen.
Kontroller både HTTP-status og JSON status før du leser response.name. Responsobjektet kan mangle ved feil. Et manglende navn skal ikke hindre at det vanlige anropet rutes.
Fakturering, nye forsøk og forskjellen fra å oppdatere anroper-ID
Et nytt oppslag kan gi en spørringskostnad. Disse oppslagsgrensesnittene dokumenterer ingen idempotensnøkkel, så et nytt forsøk kan bli en ny fakturerbar spørring. Bruk begrenset backoff ved transport-/tjenestefeil, løs kontofeil først, og avstem de rapporterte spørringskostnadene. Bruk hurtigbuffer bare i en periode som passer for applikasjonen din; anropernavndata kan endres.
Et CNAM-oppslag leser et navn. Det endrer ikke navnet som vises på dine utgående anrop. En LIDB-oppdatering av anropernavn er en separat operasjon med egne felt, autorisasjon, pris og behandling.