API för telefonvalidering och E.164-formatering

Global telefoninformation

Ett nummer, konsekvent resultat

Skicka nationella, internationella eller oregelbundet formaterade nummer och få standardiserade format samt valideringsmetadata för 242 länder och territorier.

Obearbetad indata+46 8 123 456 78

E.164-resultat+46812345678

ValideringisValid och isPossible

FormateringNationellt, internationellt och E.164

KlassificeringMobil, fast telefoni, VoIP med mera

PlatsRegion, riktnummer och ort

Indataparametrar

Nummer och adresskontext

Parameter	Krav	Beskrivning
`number`	Obligatorisk	Telefonnummer i nationellt, internationellt eller E.164-format.
`address`	Villkorad	ISO-landskod, landsnamn, stad eller region som används för att tolka ett nationellt nummer.

När address krävs

Om number inte börjar med + och ett internationellt landsnummer ska du ange kontext, exempelvis SE, Sweden eller Stockholm.

SESwedenStockholmGöteborgSverige

GET

Autentisering i query string

Grundläggande GET-förfrågan

cURL

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

URL-kodning: Koda + som %2B och mellanslag som %20. Använd språkets URL- eller URLSearchParams-verktyg i stället för att bygga strängen manuellt.

POST

Bearer-autentisering

POST-förfrågan från servern

Skicka numret och valfri adress som JSON med API-nyckeln i Authorization-headern.

cURL

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

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

API-svar

Validering, formatering och metadata

JSON

{
  "status": true, "remaining_credits": 15709, "expires": 0, "duration": "18ms",
  "regionCode": "SE", "countryCode": 46, "country": "Sweden",
  "national": "08-123 456 78", "international": "+46 8 123 456 78", "e164": "+46812345678",
  "isValid": true, "isPossible": true, "numberType": "FIXED_LINE",
  "nationalSignificantNumber": "812345678", "rawInput": "+46 8 123 456 78",
  "isGeographical": true, "areaCode": "8", "location": "Stockholm"
}

Svarsfält

Fält	Typ	Beskrivning
`status`	boolean	Anger om förfrågan slutfördes utan fel.
`remaining_credits`	integer	Krediter som återstår efter förfrågan.
`expires`	integer	Krediternas utgångstid som en UNIX-tidsstämpel.
`duration`	string	Serverns behandlingstid.
`regionCode`	string	Identifierad regionskod enligt ISO 3166-1 alpha-2.
`countryCode`	integer	Internationellt landsnummer.
`country`	string	Landets läsbara namn.
`national`	string	Numret formaterat för nationell användning.
`international`	string	Numret formaterat för internationell visning.
`e164`	string	Kanonisk representation enligt E.164.
`isValid`	boolean	Anger om numret uppfyller regionens valideringsregler.
`isPossible`	boolean	Anger om numret kan existera utifrån sin struktur.
`numberType`	string	Identifierad nummerkategori.
`nationalSignificantNumber`	string	Nationellt nummer utan internationellt landsnummer.
`rawInput`	string	Det ursprungliga numret i förfrågan.
`isGeographical`	boolean	Anger om numret kan kopplas till ett geografiskt område.
`areaCode`	string	Identifierat riktnummer eller områdesnummer.
`location`	string	Plats som är kopplad till områdesnumret.

Klassificeringsreferens

Värden för nummertyp

FIXED_LINE

Fast telefonlinje kopplad till en geografisk plats.

MOBILE

Mobiltelefonnummer.

FIXED_LINE_OR_MOBILE

Nummerplanen skiljer inte mellan fast telefoni och mobiltelefoni.

TOLL_FREE

Avgiftsfritt nummer där mottagaren betalar samtalet.

PREMIUM_RATE

Betalsamtalsnummer med förhöjd taxa.

SHARED_COST

Samtalskostnaden delas mellan den som ringer och mottagaren.

VOIP

Telefonnummer för IP-telefoni.

PERSONAL_NUMBER

Personligt nummer som kan vidarekopplas till en annan linje.

PAGER

Nummer för personsökare.

UAN

Universellt åtkomstnummer som används som gemensam företagskontakt.

VOICEMAIL

Särskilt nummer för åtkomst till röstbrevlåda.

UNKNOWN

Nummerkategorin kunde inte fastställas.

Vanliga frågor

FAQ om telefon-API:et

Vad gör API:et för telefonvalidering?

Det validerar och normaliserar telefonnummer, returnerar nationellt, internationellt och E.164-format samt identifierar region, nummertyp och geografiska metadata när de är tillgängliga.

Vad är skillnaden mellan isValid och isPossible?

isValid kontrollerar numret mot regionens nummerregler. isPossible anger att strukturen skulle kunna motsvara ett nummer även när giltigheten inte kan bekräftas.

När krävs address?

Ange address när numret inte börjar med plustecken och internationellt landsnummer. Värdet kan vara en ISO-landskod, ett landsnamn, en stad eller en region.

Hur ska specialtecken skickas?

URL-koda mellanslag, plustecken och andra specialtecken i GET-parametrar. JSON-body för POST kodas av din HTTP-klient.

Nästa referens

Övervaka användning och kvot

Användning och kvotFörstå krediter och gränser →KlientbibliotekInstallera ett paket för telefonvalidering →