Validerings- og formatterings-API til telefonnumre

Telefonnummer-validator API'en er understøttet i 242 lande.

Validerings- og formatterings-API'en til telefonnumre gør det nemt at håndtere telefonnumre indtastet af brugere i mange forskellige formater. Uanset om inputtet er så uregelmæssigt som 1(212)-867-53-09, +1 212 8675309, 001-212.867.5309 eller blot 2128675309, vil vores API intelligent opdage strukturen og returnere en standardiseret version.

Dette værktøj konverterer automatisk det givne input til E.164-formatet, som er det globalt anerkendte format til internationale telefonnumre. For eksempel bliver +1 212 867 5309 returneret som +12128675309, hvilket gør det egnet til internationale opkaldssystemer og integrationer.

Ud over formattering tilbyder API'en detaljeret validering af telefonnumre. Den kontrollerer, om nummeret er isValid: true — hvilket betyder, at det er et gyldigt nummer i henhold til nationale nummerplaner. Den tilbyder også en isPossible: true kontrol, som angiver, om et nummer potentielt kunne eksistere, selv hvis det ikke er tildelt i øjeblikket. Dette er nyttigt til forvalidering før lagring eller behandling.

Parameteren numberType hjælper med at identificere, om telefonnummeret er et mobil-, fastnet- eller VoIP-nummer. Dette er især nyttigt i scenarier, hvor du kun vil tillade mobilnumre til SMS-verifikationer eller fastnetnumre til kontakter.

Med understøttelse af områdekodegenkendelse kan API'en også opdage nummerets geografiske oprindelse. For eksempel vil et nummer, der starter med områdekode 212, automatisk blive knyttet til New York City (Manhattan). Denne funktion er perfekt til applikationer, der kræver lokalitetsbaseret segmentering eller analyse.

Hvert nummer er også forbundet med detaljeret landespecifik metadata, såsom ISO-landekoden (f.eks. US) og numerisk landekode (f.eks. 1), hvilket muliggør regionsspecifik logik og visningsformater i dine applikationer.

✅ API-svar

Eksempel på JSON-svar:

{
  "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'en selv

Grundlæggende Brug

Send et telefonnummer til følgende endpoint:

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

Du kan få din daglige gratis API-nøgle med 200 kreditter via dette link.

Adresse-parameter

API’en understøtter også en valgfri address-parameter, som er særligt nyttig i tilfælde, hvor telefonnummeret ikke indeholder en international landekode. Dette felt hjælper systemet med at identificere den tilsigtede region og korrekt fortolke nummeret. For eksempel, hvis inputnummeret er 2128675309 og ingen landekode er angivet, kan brug af address=US, address=United States eller endda address=New York hjælpe API’en med at fastslå, at nummeret tilhører USA.

Parameteren address accepterer input i flere formater, herunder:

• ISO 3166-1 alpha-2 koder som US, DE eller TR
• Landenavne som Germany, Turkey eller America
• By- eller regionsnavne som Berlin, Istanbul eller New York

Selvom parameteren er valgfri, bliver address obligatorisk, hvis telefonnummeret ikke begynder med et plus-tegn og en international landekode (f.eks. +1, +44, +90). Uden disse kontekstuelle oplysninger kan API’en have svært ved at fortolke det nationale nummer korrekt.

Eksempel med address-parameter:

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

Svarfelter

Mulige Værdier for numberType

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 via POST-anmodning

Du kan bruge POST-metoden til at validere et telefonnummer i USA. Angiv blot telefonnummeret i E.164-, nationalt eller internationalt format sammen med land/adresse. Din API-nøgle skal 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 Example

<?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 at gøre integrationen endnu nemmere tilbyder vi en række officielle og community-understøttede klientbiblioteker til forskellige programmeringssprog. Disse biblioteker giver dig mulighed for at kommunikere med GenderAPI-endpoints — såsom Phone Number Validation API — uden manuelt at håndtere HTTP-anmodninger eller JSON-parsing. Vælg blot det relevante bibliotek til dit miljø, installer det og begynd at sende forespørgsler med minimal opsætning.

Du kan finde de tilgængelige klientbiblioteker og installationsvejledninger på følgende side:
https://www.genderapi.io/da/docs-client-libraries

Ofte Stillede Spørgsmål (FAQ)

1. Hvad er Phone Number Validation & Formatter API?

Phone Number Validation & Formatter API er et værktøj, der giver dig mulighed for at validere, formatere og analysere telefonnumre fra hele verden. Det kan konvertere numre til det standardiserede E.164-format og bestemme metadata som region, type (mobil/fixednet), gyldighed og mere.

2. Hvad bruges telefonnummer-validering til?

Det bruges til at kontrollere, om et telefonnummer er gyldigt, formatere det til international brug, identificere typen (f.eks. mobil, VoIP), opdage regionsbaserede metadata og sikre ensartet telefonnummerinput til CRM, marketingværktøjer eller brugerregistrering.

3. Hvor mange lande understøttes?

API’en understøtter telefonnumre fra 242 lande og territorier over hele verden. Det sikrer global dækning til enhver international eller regional applikation.

4. Hvilke formater understøttes?

API’en accepterer numre i forskellige formater såsom nationalt, internationalt eller E.164. Den registrerer og normaliserer dem automatisk.

5. Hvad sker der, hvis jeg udelader country eller address-parameteren?

Hvis telefonnummeret ikke starter med et '+' og der ikke angives et land eller adresse, kan API’en have svært ved korrekt at fortolke nummeret. Det anbefales at inkludere address-parameteren (som US, United States eller New York).

6. Kan API’en registrere typen af nummer?

Ja. API’en returnerer feltet numberType, som angiver om nummeret er MOBILE, FIXED_LINE, VOIP osv.

7. Hvad er forskellen på isValid og isPossible?

isValid betyder, at nummeret officielt er tildelt og matcher alle regionale regler. isPossible tjekker, om nummeret teoretisk kunne eksistere ud fra dets struktur, selvom det endnu ikke er tildelt.

8. Hvilken type svar returnerer API’en?

Et vellykket svar indeholder status, formaterede nummer-varianter (nationalt, internationalt, E.164), regiondata, numertype, kreditforbrug og mere. Se sektionen med eksempel på API-svar for fuldt output.

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

For GET-anmodninger skal du tilføje nøglen som ?key=YOUR_API_KEY. For POST-anmodninger bruges Bearer-token i headeren som:
"Authorization: Bearer YOUR_API_KEY".

10. Hvad betyder det, hvis jeg ser status: false i svaret?

Det betyder, at anmodningen mislykkedes. Feltet message vil indeholde en detaljeret fejlbeskrivelse, f.eks. manglende parametre, ugyldigt telefonnummer eller utilstrækkelige kreditter.

11. Er specialtegn eller mellemrum tilladt i input?

Ja, men de skal URL-enkodes ved GET-anmodninger. Brug f.eks. %20 i stedet for mellemrum. Se advarselssektionen ovenfor for korrekt brug.

12. Kan jeg bruge adresser i forskellige formater eller sprog?

Ja. Ud over ISO 3166-1 alpha-2-koder (som US, DE, TR) accepterer address-parameteren også fulde landenavne eller bynavne — selv på forskellige sprog. API’en anvender indbygget AI til intelligent at registrere og fortolke det korrekte land eller region. For eksempel:

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

Alle disse input vil korrekt blive kortlagt til deres respektive lande eller regioner af API’en uden problemer.