API för Validering och Formatering av Telefonnummer

API:t för telefonvalidering stöds i 242 länder.

API:t för validering och formatering av telefonnummer gör det enkelt att behandla telefonnummer som användare har angett i många olika format. Oavsett om inmatningen är så oregelbunden som 1(212)-867-53-09, +1 212 8675309, 001-212.867.5309 eller helt enkelt 2128675309, kommer vårt API att intelligent identifiera strukturen och returnera en standardiserad version.

Detta verktyg konverterar automatiskt det angivna numret till E.164-format, vilket är det globalt erkända formatet för internationella telefonnummer. Till exempel returneras +1 212 867 5309 som +12128675309, vilket gör det lämpligt för internationella samtalssystem och integrationer.

Utöver formatering erbjuder API:t detaljerad validering av telefonnummer. Det kontrollerar om numret är isValid: true — vilket innebär att det är ett giltigt nummer enligt nationella nummerplaner. Det ger även en isPossible: true-kontroll, vilket indikerar om ett nummer potentiellt skulle kunna existera även om det inte för närvarande är tilldelat. Detta är användbart för förvalidering innan lagring eller vidare behandling.

Parametern numberType hjälper till att identifiera om telefonnumret är ett mobil-, fastnäts- eller VoIP-nummer. Detta är särskilt användbart i situationer där du bara vill tillåta mobilnummer för SMS-verifieringar eller fastnätsnummer för kontakter på kontor.

Med stöd för upptäckt av riktnummer kan API:t även identifiera numrets geografiska ursprung. Till exempel mappas ett nummer som börjar med riktnummer 212 automatiskt till New York City (Manhattan). Denna funktion är perfekt för applikationer som kräver platsbaserad segmentering eller analys.

Varje nummer är också kopplat till detaljerad landsbaserad metadata, såsom ISO-regionkod (t.ex. US) och numerisk landskod (t.ex. 1), vilket möjliggör regionsspecifik logik och presentationsformat i dina applikationer.

✅ API-svar

Exempel 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)"
}

Prova API:t för telefonvalidering själv

Grundläggande användning

Skicka ett telefonnummer till följande slutpunkt:

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

Du kan få din dagliga gratis API-nyckel med 200 krediter via den här länken.

Adressparameter

API:t stöder också en valfri address-parameter, vilket kan vara mycket användbart när telefonnumret anges utan internationell landskod. Detta fält hjälper systemet att identifiera avsedd region och korrekt tolka numret. Till exempel, om det angivna numret är 2128675309 och ingen landskod anges, kan inställning av address=US, address=United States eller till och med address=New York hjälpa API:t att avgöra att numret tillhör USA.

Parametern address accepterar indata i flera format, inklusive:

• ISO 3166-1 alpha-2-koder såsom US, DE eller TR
• Landsnamn såsom Tyskland, Turkiet eller Amerika
• Stads- eller regionnamn som Berlin, Istanbul eller New York

Även om det är valfritt, blir address obligatoriskt om telefonnumret inte börjar med ett plustecken och en internationell uppringningskod (t.ex. +1, +44, +90). Utan denna kontextuella information kan API:t ha svårt att tolka det nationella nummerformatet korrekt.

Exempel med adressparameter:

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

Responsfält

Värden för Nummertyp

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-förfrågan

Du kan använda POST-metoden för att validera ett telefonnummer i USA. Ange helt enkelt telefonnumret i E.164-, nationellt eller internationellt format tillsammans med land/adress. Din API-nyckel måste skickas som en Bearer-token.

cURL-exempel

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-exempel

<?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-exempel

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-exempel

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())

Klientbibliotek

För att göra integrationen ännu enklare erbjuder vi ett antal officiella och community-stödda klientbibliotek för olika programmeringsspråk. Dessa bibliotek låter dig interagera med GenderAPI:s slutpunkter — som API:t för telefonnummervalidering — utan att manuellt behöva hantera HTTP-förfrågningar eller JSON-avkodning. Välj bara det bibliotek som passar din miljö, installera det och börja göra förfrågningar med minimal konfiguration.

Du hittar tillgängliga klientbibliotek och installationsinstruktioner på följande sida:
https://www.genderapi.io/sv/docs-client-libraries

Vanliga Frågor (FAQ)

1. Vad är API:t för validering och formatering av telefonnummer?

API:t för validering och formatering av telefonnummer är ett verktyg som låter dig validera, formatera och analysera telefonnummer från hela världen. Det kan konvertera nummer till det standardiserade E.164-formatet och avgöra metadata som region, typ (mobil/fastnäts), giltighet och mer.

2. Vad används telefonnummervalidering till?

Det används för att kontrollera om ett telefonnummer är giltigt, formatera det för internationell användning, identifiera numrets typ (t.ex. mobil, VoIP), upptäcka regionsbaserad metadata och säkerställa ren, standardiserad telefonnummerinmatning för CRM, marknadsföringsverktyg eller användarregistreringar.

3. Hur många länder stöds?

API:t stöder telefonnummer från 242 länder och territorier världen över. Detta säkerställer global täckning för alla internationella eller regionala applikationer.

4. Vilka format stöds?

API:t accepterar nummer i olika format såsom nationellt, internationellt eller E.164. Det upptäcker och normaliserar dem automatiskt till korrekt format.

5. Vad händer om jag utelämnar lands- eller adressparametern?

Om telefonnumret inte börjar med ett '+' och inget land/adress anges, kanske API:t inte kan tolka numret korrekt. Det rekommenderas att inkludera parametern address (som US, United States eller New York).

6. Kan API:t upptäcka numrets typ?

Ja. API:t returnerar fältet numberType som indikerar om numret är MOBILE, FIXED_LINE, VOIP, etc.

7. Vad är skillnaden mellan isValid och isPossible?

isValid betyder att numret officiellt är tilldelat och matchar alla regionala regler. isPossible kontrollerar om numret teoretiskt sett kan existera baserat på dess struktur, även om det inte är tilldelat ännu.

8. Vad innehåller ett API-svar?

Ett lyckat svar innehåller status, formaterade versioner av numret (nationellt, internationellt, E.164), regionsdata, numertyp, kreditförbrukning och mer. Se avsnittet med exempelsvar för en fullständig utskrift.

9. Hur ska jag skicka min API-nyckel?

För GET-förfrågningar, lägg till nyckeln som ?key=YOUR_API_KEY. För POST-förfrågningar, använd en Bearer-token i headern enligt följande:
"Authorization: Bearer YOUR_API_KEY".

10. Vad betyder ett svar med status: false?

Det betyder att begäran misslyckades. Fältet message kommer att innehålla en detaljerad felorsak såsom saknade parametrar, ogiltigt telefonnummer eller otillräckliga krediter.

11. Är specialtecken eller mellanslag tillåtna i indata?

Ja, men de måste URL-kodas för GET-förfrågningar. Använd till exempel %20 istället för ett mellanslag. Se varningsavsnittet ovan för korrekt användning.

12. Kan jag använda adresser i olika format eller språk?

Ja. Förutom ISO 3166-1 alpha-2-koder (som US, DE, TR), accepterar parametern address även fullständiga landsnamn eller stadsnamn — även på olika språk. API:t använder inbyggd AI för att intelligent identifiera och tolka rätt land eller region. Till exempel:

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

Alla dessa inmatningar kommer att korrekt matchas med sina respektive länder eller regioner av API:t utan problem.