API for telefonnummer-validering og E.164-formatering

Global telefoninformasjon

Ett nummer, konsekvent resultat

Send nasjonale, internasjonale eller uregelmessig formaterte numre, og motta standardiserte formater og valideringsmetadata for 242 land og territorier.

Rådata+1 212 867 5309

E.164-resultat+12128675309

ValideringisValid og isPossible

FormateringNasjonalt, internasjonalt og E.164

KlassifiseringMobil, fasttelefon, VoIP og mer

StedRegion, retningsnummer og sted

Inndataparametere

Nummer og adressekontekst

Parameter	Krav	Beskrivelse
`number`	Påkrevd	Telefonnummer i nasjonalt, internasjonalt eller E.164-format.
`address`	Betinget	ISO-landkode, land, by eller region som brukes til å tolke et nasjonalt nummer.

Når address blir påkrevd

Hvis number ikke begynner med + og et internasjonalt landsnummer, må du oppgi kontekst, for eksempel NO, Norway eller Oslo.

NONorgeOsloBergenNorway

GET

Autentisering i spørringsstrengen

Enkel GET-forespørsel

cURL

curl "https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=%2B12128675309&address=US"

URL-koding: Kod + som %2B og mellomrom som %20. Bruk helst språkets URL- eller URLSearchParams-verktøy fremfor å bygge strengen manuelt.

POST

Bearer-autentisering

POST-forespørsel fra server

Send nummeret og valgfri adresse som JSON, med API-nøkkelen i Authorization-headeren.

cURL

curl -X POST "https://api.genderapi.io/api/phone" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"number":"+12128675309","address":"US"}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/phone", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ number: "+12128675309", address: "United States" })
});

API-svar

Validering, formatering og metadata

JSON

{
  "status": true, "remaining_credits": 15709, "expires": 0, "duration": "18ms",
  "regionCode": "US", "countryCode": 1, "country": "United States",
  "national": "(212) 867-5309", "international": "+1 212-867-5309", "e164": "+12128675309",
  "isValid": true, "isPossible": true, "numberType": "FIXED_LINE_OR_MOBILE",
  "nationalSignificantNumber": "2128675309", "rawInput": "+1 212 867 5309",
  "isGeographical": true, "areaCode": "212", "location": "New York City (Manhattan)"
}

Svarfelter

Felt	Type	Beskrivelse
`status`	boolean	Om forespørselen ble fullført.
`remaining_credits`	integer	Tilgjengelige kreditter etter forespørselen.
`expires`	integer	Kredittenes utløpstid som UNIX-tidsstempel.
`duration`	string	Behandlingstid på serveren.
`regionCode`	string	Oppdaget ISO 3166-1 alfa-2-regionkode.
`countryCode`	integer	Internasjonalt landsnummer.
`country`	string	Lesbart navn på landet.
`national`	string	Nummer formatert for nasjonal bruk.
`international`	string	Nummer formatert for internasjonal visning.
`e164`	string	Kanonisk representasjon i E.164-format.
`isValid`	boolean	Om nummeret oppfyller regionale valideringsregler.
`isPossible`	boolean	Om nummeret kan eksistere ut fra strukturen.
`numberType`	string	Oppdaget nummerkategori.
`nationalSignificantNumber`	string	Nasjonalt nummer uten landsnummer.
`rawInput`	string	Det opprinnelige nummeret i forespørselen.
`isGeographical`	boolean	Om nummeret kan knyttes til et geografisk område.
`areaCode`	string	Oppdaget retningsnummer.
`location`	string	Stedet som er knyttet til retningsnummeret.

Referanse for klassifisering

Verdier for nummertype

FIXED_LINE

Fasttelefon knyttet til et geografisk område.

MOBILE

Mobiltelefonnummer.

FIXED_LINE_OR_MOBILE

Nummerplanen skiller ikke mellom fasttelefon og mobil.

TOLL_FREE

Avgiftsfritt nummer der mottakeren betaler.

PREMIUM_RATE

Betalingsnummer med forhøyet takst.

SHARED_COST

Samtalekostnaden deles mellom innringer og mottaker.

VOIP

Telefonnummer for Voice over IP.

PERSONAL_NUMBER

Personlig nummer som kan viderekobles til en annen linje.

PAGER

Nummer for personsøker.

UAN

Universelt tilgangsnummer brukt som felles bedriftskontakt.

VOICEMAIL

Eget tilgangsnummer for telefonsvarer.

UNKNOWN

Nummerkategorien kunne ikke fastslås.

Vanlige spørsmål

Vanlige spørsmål om telefon-API-et

Hva gjør API-et for telefonvalidering?

Det validerer og normaliserer telefonnumre, returnerer nasjonalt, internasjonalt og E.164-format og identifiserer region, nummertype og geografiske metadata når de er tilgjengelige.

Hva er forskjellen mellom isValid og isPossible?

isValid kontrollerer nummeret mot regionale nummerregler. isPossible viser at strukturen kan tilsvare et telefonnummer, selv om gyldigheten ikke kan bekreftes.

Når er address påkrevd?

Oppgi address når nummeret ikke begynner med plusstegn og internasjonalt landsnummer. Verdien kan være en ISO-landkode, et land, en by eller en region.

Hvordan skal spesialtegn sendes?

URL-kod mellomrom, plusstegn og andre spesialtegn i GET-parametere. JSON-data i POST-forespørsler kodes av HTTP-klienten.

Neste referanse

Følg med på bruk og kvote

Bruk og kvoteForstå kreditter og grenser →KlientbibliotekerInstaller en pakke for telefonvalidering →