Telefonnummervalidering og -formaterings-API

Telefonvaliderings-API-et er støttet i 242 land.

Telefonnummervalidering og -formaterings-API-et lar deg enkelt behandle telefonnumre som brukere skriver inn i ulike formater. Enten inndataene er så uregelmessige som 1(212)-867-53-09, +1 212 8675309, 001-212.867.5309 eller bare 2128675309, vil API-et vårt intelligent oppdage strukturen og returnere en standardisert versjon.

Dette verktøyet konverterer automatisk det angitte inndata til E.164-format, som er det globalt anerkjente formatet for internasjonale telefonnumre. For eksempel blir +1 212 867 5309 returnert som +12128675309, noe som gjør det egnet for internasjonale oppringingssystemer og integrasjoner.

I tillegg til formatering tilbyr API-et detaljert validering av telefonnummer. Det sjekker om nummeret er isValid: true — som betyr at det er gyldig i henhold til nasjonale nummerplaner. Det tilbyr også en isPossible: true-sjekk, som indikerer om et nummer potensielt kan eksistere selv om det ikke er tildelt ennå. Dette er nyttig for forhåndsvalidering før lagring eller behandling.

Parameteren numberType hjelper deg med å identifisere om telefonnummeret er et mobil-, fastlinje- eller VoIP-nummer. Dette er spesielt nyttig i situasjoner der du bare vil tillate mobilnumre for SMS-verifiseringer eller fastlinjer for kontakter.

Med støtte for gjenkjenning av retningsnummer kan API-et også oppdage nummerets geografiske opprinnelse. For eksempel blir et nummer som starter med retningsnummer 212 automatisk tilordnet til New York City (Manhattan). Denne funksjonen er perfekt for applikasjoner som krever stedsbasert segmentering eller analyse.

Hvert nummer er også knyttet til detaljert metadata på landsnivå, som ISO-regionkode (f.eks. US) og numerisk landskode (f.eks. 1), noe som muliggjør regionspesifikk logikk og visningsformater i applikasjonene dine.

✅ API-respons

Eksempel på JSON-respons:

{
  "status": true,
  "remaining_credits": 15709,
  "expires": 0,
  "duration": "18ms",
  "regionCode": "US",
  "countryCode": 1,
  "country":"Unites 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)"
}

Prøv telefonvaliderings-API-et selv

Grunnleggende bruk

Send et telefonnummer til følgende endepunkt:

https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=12128675309

Du kan få din daglige gratis API-nøkkel med 200 kreditter fra denne lenken.

Address-parameter

API-et støtter også en valgfri address-parameter, som kan være svært nyttig i tilfeller der telefonnummeret er oppgitt uten internasjonal landskode. Dette feltet hjelper systemet med å oppdage ønsket region og tolke nummeret riktig. For eksempel, hvis inndataen er 2128675309 og ingen landskode er angitt, kan det å sette address=US, address=United States eller til og med address=New York hjelpe API-et med å avgjøre at nummeret tilhører USA.

address-parameteren godtar inndata i flere formater, inkludert:

• ISO 3166-1 alpha-2-koder som US, DE eller TR
• Landsnavn som Tyskland, Tyrkia eller Amerika
• By- eller regionnavn som Berlin, Istanbul eller New York

Selv om den er valgfri, blir address obligatorisk dersom telefonnummeret ikke begynner med et plusstegn og en internasjonal retningskode (f.eks. +1, +44, +90). Uten denne konteksten kan det hende API-et ikke tolker det nasjonale nummerformatet riktig.

Eksempel med address-parameter:

https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=12128675309&address=US

Responsfelter

Verdier for nummerstype

curl "https://api.genderapi.io/api/phone?number=+49 151 12345678&address=United States&key=YOUR_API_KEY"

curl "https://api.genderapi.io/api/phone?number=%2B49%20151%2012345678&address=United%20States&key=YOUR_API_KEY"

Telefonvaliderings-API med POST-forespørsel

Du kan bruke POST-metoden for å validere et telefonnummer for USA. Oppgi bare telefonnummeret i E.164-, nasjonalt- eller internasjonalt format sammen med land/adresse. Din API-nøkkel må sendes som et Bearer-token.

cURL-eksempel

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"}'

PHP cURL-eksempel

<?php
$url = "https://api.genderapi.io/api/phone";

$data = array(
    "number" => "+12128675309",
    "address" => "US"
);

$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Content-Type: application/json",
    "Authorization: Bearer YOUR_API_KEY"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

JavaScript fetch-eksempel

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"
  })
})
.then(response => response.json())
.then(data => console.log(data));

Python requests-eksempel

import requests

url = "https://api.genderapi.io/api/phone"

payload = {
    "number": "+12128675309",
    "address": "United States"
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Klientbiblioteker

For å gjøre integrasjonen enda enklere, tilbyr vi et utvalg av offisielle og fellesskapsstøttede klientbiblioteker for ulike programmeringsspråk. Disse bibliotekene lar deg kommunisere med GenderAPI-endepunktene — som Telefonnummervaliderings-API-et — uten å måtte håndtere HTTP-forespørsler eller JSON-analyse manuelt. Velg ganske enkelt riktig bibliotek for ditt miljø, installer det og begynn å sende forespørsler med minimal oppsett.

Du finner tilgjengelige klientbiblioteker og installasjonsinstruksjoner på følgende side:
https://www.genderapi.io/nb/docs-client-libraries

Ofte stilte spørsmål (FAQ)

1. Hva er Telefonnummervaliderings- og Formatterings-API-et?

Telefonnummervaliderings- og Formatterings-API-et er et verktøy som lar deg validere, formatere og analysere telefonnumre fra hele verden. Det kan konvertere numre til det standardiserte E.164-formatet og fastslå metadata som region, type (mobil/fastlinje), gyldighet og mer.

2. Hva brukes telefonnummervalidering til?

Det brukes til å sjekke om et telefonnummer er gyldig, formatere det for internasjonal bruk, identifisere typen nummer (f.eks. mobil, VoIP), oppdage regionsbasert metadata og sikre rene, standardiserte telefonnummerdata for CRM, markedsføringsverktøy eller brukerregistrering.

3. Hvor mange land støttes?

API-et støtter telefonnumre fra 242 land og territorier over hele verden. Dette sikrer global dekning for enhver internasjonal eller regional applikasjon.

4. Hvilke formater støttes?

API-et aksepterer numre i ulike formater som nasjonalt, internasjonalt eller E.164. Det oppdager og normaliserer dem automatisk til riktig format.

5. Hva skjer hvis jeg utelater land- eller adresseparameteren?

Hvis telefonnummeret ikke starter med «+» og det ikke oppgis et land eller en adresse, kan API-et ha problemer med å tolke nummeret korrekt. Det anbefales å inkludere address-parameteren (f.eks. US, United States eller New York).

6. Kan API-et oppdage nummerets type?

Ja. API-et returnerer feltet numberType som angir om nummeret er MOBILE, FIXED_LINE, VOIP, osv.

7. Hva er forskjellen mellom isValid og isPossible?

isValid betyr at nummeret er offisielt tildelt og samsvarer med alle regionale regler. isPossible sjekker om nummeret teoretisk sett kan eksistere basert på strukturen, selv om det ikke er tildelt.

8. Hva slags respons returnerer API-et?

En vellykket respons inkluderer status, formaterte nummer (nasjonalt, internasjonalt, E.164), regiondata, nummerets type, kredittbruk og mer. Se seksjonen med eksempelrespons for fullstendig utdata.

9. Hvordan skal jeg sende API-nøkkelen min?

For GET-forespørsler, legg til nøkkelen som ?key=YOUR_API_KEY. For POST-forespørsler, bruk Bearer-token i headeren slik:
"Authorization: Bearer YOUR_API_KEY".

10. Hva betyr det hvis jeg får status: false?

Det betyr at forespørselen mislyktes. Feltet message vil inneholde en detaljert feilmelding som manglende parametere, ugyldig telefonnummer eller utilstrekkelige kreditter.

11. Er spesialtegn eller mellomrom tillatt i inndata?

Ja, men de må URL-kodes for GET-forespørsler. For eksempel, bruk %20 i stedet for et mellomrom. Se advarselsseksjonen ovenfor for riktig bruk.

12. Kan jeg bruke adresser i forskjellige formater eller språk?

Ja. I tillegg til ISO 3166-1 alpha-2-koder (som US, DE, TR), godtar address-parameteren også fullstendige landsnavn eller bynavn — selv på forskjellige språk. API-et bruker innebygd AI for å intelligent gjenkjenne og tolke riktig land eller region. For eksempel:

address=Deutschland
address=États-Unis
address=İstanbul
address=New York
address=Estados Unidos

Alle disse inndataene blir korrekt tilknyttet sine respektive land eller regioner av API-et uten problemer.