API pro ověření a formátování telefonních čísel

Globální analýza telefonních čísel

Jedno číslo, jednotný výstup

Přijímejte národní, mezinárodní i nepravidelně zapsané vstupy a získejte standardizované formáty spolu s ověřovacími údaji pro 242 zemí a území.

Původní vstup+420 212 345 678

Výstup E.164+420212345678

OvěřeníisValid a isPossible

FormátováníNárodní, mezinárodní a E.164

KlasifikaceMobilní, pevná linka, VoIP a další

LokalitaOblast, předvolba a místo

Vstupní parametry

Číslo a kontext oblasti

Parametr	Požadavek	Popis
`number`	Povinné	Telefonní číslo v národním, mezinárodním nebo E.164 formátu.
`address`	Podmíněné	Kód země ISO, název země, město nebo oblast použité k interpretaci národního čísla.

Kdy je parametr address povinný

Pokud number nezačíná znakem + a mezinárodní předvolbou, uveďte kontext, napříkladCZ, Czechia nebo Prague.

CZCzechiaPrahaBrnoČeská republika

GET

Autentizace v parametru URL

Základní požadavek GET

cURL

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

Kódování URL: Znak + kódujte jako %2B a mezery jako %20. Místo ručního sestavování řetězce použijte nástroje URL nebo URLSearchParams svého jazyka.

POST

Autentizace Bearer

Serverový požadavek POST

Číslo a volitelnou oblast odešlete jako JSON; API klíč vložte do hlavičky Authorization.

cURL

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

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: "+12128675309", address: "United States" })
});

Odpověď API

Ověření, formátování a metadata

JSON

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

Pole odpovědi

Pole	Typ	Popis
`status`	boolean	Určuje, zda byl požadavek úspěšně zpracován.
`remaining_credits`	integer	Počet kreditů dostupných po požadavku.
`expires`	integer	Čas vypršení kreditů jako časové razítko UNIX.
`duration`	string	Doba zpracování na serveru.
`regionCode`	string	Rozpoznaný kód oblasti ISO 3166-1 alpha-2.
`countryCode`	integer	Mezinárodní telefonní předvolba.
`country`	string	Srozumitelný název země.
`national`	string	Číslo naformátované pro vnitrostátní použití.
`international`	string	Číslo naformátované pro mezinárodní zobrazení.
`e164`	string	Kanonický zápis ve formátu E.164.
`isValid`	boolean	Určuje, zda číslo splňuje pravidla číslovacího plánu oblasti.
`isPossible`	boolean	Určuje, zda by číslo podle své struktury mohlo existovat.
`numberType`	string	Rozpoznaná kategorie telefonního čísla.
`nationalSignificantNumber`	string	Národní číslo bez mezinárodní předvolby země.
`rawInput`	string	Původní číslo odeslané v požadavku.
`isGeographical`	boolean	Určuje, zda lze číslo přiřadit ke geografické oblasti.
`areaCode`	string	Rozpoznaná část s místní předvolbou.
`location`	string	Lokalita přiřazená k místní předvolbě.

Přehled klasifikace

Hodnoty typu telefonního čísla

FIXED_LINE

Pevná linka vázaná na geografickou oblast.

MOBILE

Mobilní nebo celulární číslo.

FIXED_LINE_OR_MOBILE

Číslovací plán nerozlišuje pevnou linku od mobilního čísla.

TOLL_FREE

Bezplatné číslo hrazené příjemcem.

PREMIUM_RATE

Číslo služby se zvýšenou sazbou.

SHARED_COST

Cena hovoru se dělí mezi volajícího a příjemce.

VOIP

Telefonní číslo služby Voice over IP.

PERSONAL_NUMBER

Osobní číslo, které může přesměrovat hovor na jinou linku.

PAGER

Číslo pagerové služby.

UAN

Univerzální přístupové číslo používané jako společný firemní kontakt.

VOICEMAIL

Vyhrazené číslo pro přístup k hlasové schránce.

UNKNOWN

Kategorii čísla se nepodařilo určit.

Časté otázky

Časté otázky k telefonnímu API

Co dělá API pro ověření telefonních čísel?

Ověřuje a normalizuje telefonní čísla, vrací národní, mezinárodní a E.164 formát a podle dostupnosti rozpozná oblast, typ čísla a geografická metadata.

Jaký je rozdíl mezi isValid a isPossible?

isValid kontroluje číslo podle pravidel regionálního číslovacího plánu. isPossible uvádí, že struktura může odpovídat telefonnímu číslu, i když nelze potvrdit jeho platnost.

Kdy je parametr address povinný?

Parametr address uveďte, pokud číslo nezačíná znaménkem plus a mezinárodní předvolbou. Hodnotou může být kód země ISO, název země, město nebo oblast.

Jak odesílat speciální znaky?

V parametrech GET kódujte mezery, znaménka plus a další speciální znaky pro URL. Tělo JSON požadavku POST zakóduje váš HTTP klient.

Další referenční příručka

Sledujte využití a kvótu

Využití a kvótaPochopte kredity a limity →Klientské knihovnyNainstalujte balíček pro ověření telefonu →