API til telefonvalidering og E.164-formatering

Global telefoninformation

Ét nummer, ensartet resultat

Indsend nationale, internationale eller uregelmæssigt formaterede numre, og modtag standardiserede formater samt valideringsmetadata for 242 lande og territorier.

Rå input+45 32 12 34 56

E.164-resultat+4532123456

ValideringisValid og isPossible

FormateringNationalt, internationalt og E.164

KlassificeringMobil, fastnet, VoIP og mere

LokationRegion, områdekode og sted

Inputparametre

Nummer og adressekontekst

Parameter	Krav	Beskrivelse
`number`	Påkrævet	Telefonnummer i nationalt, internationalt eller E.164-format.
`address`	Betinget	ISO-landekode, landenavn, by eller region, der bruges til at fortolke et nationalt nummer.

Når address er påkrævet

Hvis number ikke begynder med + og en international landekode, skal du angive kontekst, eksempelvis DK, Denmark eller Copenhagen.

DKDenmarkCopenhagenAarhusDanmark

GET

Godkendelse i query-string

Grundlæggende GET-anmodning

cURL

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

URL-kodning: Kod + som %2B og mellemrum som %20. Brug sprogets URL- eller URLSearchParams-værktøjer i stedet for at opbygge strengen manuelt.

POST

Bearer-godkendelse

POST-anmodning fra serveren

Send nummeret og en valgfri adresse som JSON med API-nøglen 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":"+4532123456","address":"DK"}'

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: "+4532123456", address: "Denmark" })
});

API-svar

Validering, formatering og metadata

JSON

{
  "status": true, "remaining_credits": 15709, "expires": 0, "duration": "18ms",
  "regionCode": "DK", "countryCode": 45, "country": "Denmark",
  "national": "32 12 34 56", "international": "+45 32 12 34 56", "e164": "+4532123456",
  "isValid": true, "isPossible": true, "numberType": "FIXED_LINE",
  "nationalSignificantNumber": "32123456", "rawInput": "+45 32 12 34 56",
  "isGeographical": false, "areaCode": "", "location": ""
}

Svarfelter

Felt	Type	Beskrivelse
`status`	boolean	Angiver, om anmodningen blev gennemført uden fejl.
`remaining_credits`	integer	Kreditter, der er tilbage efter anmodningen.
`expires`	integer	Kreditternes udløbstid som et UNIX-tidsstempel.
`duration`	string	Serverens behandlingstid.
`regionCode`	string	Registreret regionskode i ISO 3166-1 alpha-2-format.
`countryCode`	integer	International landekode.
`country`	string	Landets læsevenlige navn.
`national`	string	Nummeret formateret til national brug.
`international`	string	Nummeret formateret til international visning.
`e164`	string	Kanonisk repræsentation i E.164-format.
`isValid`	boolean	Angiver, om nummeret opfylder regionens valideringsregler.
`isPossible`	boolean	Angiver, om nummeret kan eksistere ud fra sin struktur.
`numberType`	string	Registreret nummerkategori.
`nationalSignificantNumber`	string	Nationalt nummer uden international landekode.
`rawInput`	string	Det oprindelige nummer i anmodningen.
`isGeographical`	boolean	Angiver, om nummeret kan knyttes til et geografisk område.
`areaCode`	string	Registreret områdekode.
`location`	string	Sted, der er knyttet til områdekoden.

Klassifikationsreference

Værdier for nummertype

FIXED_LINE

Fastnetnummer knyttet til et geografisk område.

MOBILE

Mobiltelefonnummer.

FIXED_LINE_OR_MOBILE

Nummerplanen skelner ikke mellem fastnet og mobil.

TOLL_FREE

Gratisnummer, hvor modtageren betaler for opkaldet.

PREMIUM_RATE

Betalingsnummer med forhøjet takst.

SHARED_COST

Opkaldsprisen deles mellem den, der ringer, og modtageren.

VOIP

Telefonnummer til IP-telefoni.

PERSONAL_NUMBER

Personligt nummer, der kan viderestilles til en anden linje.

PAGER

Nummer til personsøger.

UAN

Universelt adgangsnummer, der bruges som fælles virksomhedskontakt.

VOICEMAIL

Særligt nummer til adgang til telefonsvarer.

UNKNOWN

Nummerkategorien kunne ikke fastslås.

Ofte stillede spørgsmål

FAQ om telefon-API’et

Hvad gør API’et til telefonvalidering?

Det validerer og normaliserer telefonnumre, returnerer nationalt, internationalt og E.164-format og identificerer region, nummertype og geografiske metadata, når de er tilgængelige.

Hvad er forskellen på isValid og isPossible?

isValid kontrollerer nummeret i forhold til regionens nummerregler. isPossible angiver, at strukturen kan svare til et nummer, selv om gyldigheden ikke kan bekræftes.

Hvornår er address påkrævet?

Angiv address, når nummeret ikke begynder med et plustegn og en international landekode. Værdien kan være en ISO-landekode, et landenavn, en by eller en region.

Hvordan skal specialtegn sendes?

URL-kod mellemrum, plustegn og andre specialtegn i GET-parametre. JSON-bodyen til POST kodes af din HTTP-klient.

Næste reference

Overvåg brug og kvote

Brug og kvoteForstå kreditter og grænser →KlientbibliotekerInstallér en pakke til telefonvalidering →