Slå opp navnet på en innringer

Slå opp navnet på en innringer

Hent et tilgjengelig resultat for innringernavnet til et telefonnummer. Dette er et oppslag i produksjonsmiljøet og kan belaste kontoen din, også når resultatet kommer fra tjenestens hurtigbuffer. Det endrer ikke navnet som vises ved utgående anrop fra et nummer du eier.

Et returnert navn bekrefter ikke identitet, eierskap eller tillatelse til å ringe. Navn kan mangle, være utdaterte eller forkortede, eller være geografiske betegnelser eller et telefonnummer brukt som reserveverdi.

Forespørsel

Bruk den aktiverte API-kontoen din fra dens tillatte kilde-IP-adresse. Oppbevar påloggingsopplysninger i et hemmelighetslager på serversiden. Eksemplet bruker miljøvariabler og et fiktivt nordamerikansk nummer; ikke legg påloggingsopplysninger i URL-er eller offentlig tilgjengelig nettleserkode.

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

Oppgi hele nummeret som sifre, inkludert landskoden, for eksempel elleve sifre som begynner med 1 for Nord-Amerika. Ikke stol på at behandlingsfunksjonen normaliserer skilletegn eller et plusstegn. Det kreves verken forespørselskropp eller valg av region. Bekreft med MultiTEL at dekningen støtter den tiltenkte bruken.

Svar

Verdiene er bare eksempler; kostnaden er ikke et pristilbud.

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

Belastninger og avstemming

Resultater med navn belastes til kontoens konfigurerte CNAM-pris. Et gjentatt oppslag eller et oppslag fra hurtigbufferen kan føre til en ny belastning; ingen idempotensnøkkel er tilgjengelig. Kontroller kontoens gjeldende sats før du aktiverer automatiserte oppslag.

Det finnes en kjent begrensning i svaret når navnet i hurtigbufferen er tomt: behandlingsfunksjonen kan returnere API-kode 200 med et tomt navn, en kostnad som ikke er null, og en redusert beregnet saldo, selv om denne behandlingsgrenen ikke belaster kontoen. Ikke betrakt dette svaret alene som bevis på en belastning. Avstem mot kontoens faktureringsoppføringer og et nytt saldooppslag, og kontakt kundestøtte ved uklare resultater.

Kontrollen av forhåndsbetalt saldo krever for øyeblikket minst 0.004 i saldo før oppslaget, uavhengig av den konfigurerte prisen per spørring. En konto der kjøp er deaktivert, blir også avvist. Disse kontrollene gjør ikke dette endepunktet til et API for pristilbud eller forbruksgrenser.

Feil og nye forsøk

Kontroller både HTTP-statusen og status.code/status.msg i JSON. API-kode 403 kan bety utilstrekkelig forhåndsbetalt saldo, forbud mot kjøp, et problem med kontoens autorisasjon eller at ingen innringernavn ble funnet. Behandlingsforløpet for manglende navn kan returnere koden som en tekststreng. Les meldingen fremfor å tolke hver 403 som feil påloggingsopplysninger. Konfigurasjonskonflikter kan returnere API-kode 500.

Et tidsavbrudd kan oppstå etter et fakturerbart oppslag. Bruk et begrenset antall nye forsøk med økende ventetid bare når det passer for applikasjonen din, og avstem først forsøk med usikkert utfall. Ikke gjenta forespørsler for et avvist nummer eller etter feil knyttet til kontotillatelser eller saldo. En hurtigbuffer for svar i din egen applikasjon kan redusere gjentatte forespørsler, innenfor rammene av avtalen din og kravene til nøyaktighet.

Andre nummeroperasjoner

Denne leseoperasjonen er atskilt fra oppdatering av navn for utgående anrop eller LIDB, oppføring i en telefonkatalog eller registrering av en innringer. Disse operasjonene har egne obligatoriske felter, krav til autorisasjon og gebyrer. Bruk dekning for nummertildeling for å kontrollere prefikstabellen eller nummersøk for å finne numre som kan bestilles. Ingen av disse operasjonene bekrefter at en innringer er den vedkommende utgir seg for å være.