Hovory a čísla
Ověření a formátování telefonního čísla
Pokrytí: Funguje pro všechny země a využívá data číslovacích plánů z open-source knihovny libphonenumber. Čísla zadaná bez + se čtou jako čísla země této edice. NoCall doplňuje nový španělský rozsah 400 a jeho čísla informací 118xx, která knihovna zatím nepopisuje.
Otevřít nástrojNa této stránce
Účel
Ověřte, zda je telefonní číslo platné, zda jde o mobilní číslo, pevnou linku, bezplatnou nebo placenou linku, a zobrazte ho ve formátu E.164, vnitrostátním a mezinárodním.
Požadavky
Tyto návody může číst kdokoli, i bez účtu. Některé nástroje vyžadují Pro, jak uvádí příslušný návod.
Vložte libovolné telefonní číslo a ověřte, zda je platné, o jaký druh čísla jde a jak ho zapsat ve formátu E.164, vnitrostátním a mezinárodním.
Jak používat
Otevřít nástroj
Vložte libovolné telefonní číslo a ověřte, zda je platné, o jaký druh čísla jde a jak ho zapsat ve formátu E.164, vnitrostátním a mezinárodním.
Zkontrolovat
Čtěte dostupná pole spolu s omezeními. Prázdný výsledek nedokazuje bezpečnost ani neurčuje totožnost osoby.
Smyšlený příklad
Smyšlený příklad, nikoli skutečný dotaz. Nevolejte ani neotevírejte jeho odkazy.
+44 1632 960123Jak chápat výsledek
Čtěte dostupná pole spolu s omezeními. Prázdný výsledek nedokazuje bezpečnost ani neurčuje totožnost osoby.
Je to mezinárodní standard zápisu čísla: znaménko plus, mezinárodní předvolba země a vnitrostátní číslo, bez mezer a bez úvodní nuly. Aplikace a telefonní systémy v něm čísla ukládají.
Ne. Platné znamená, že patří do rozsahu přiděleného v číslovacím plánu. Zda je právě toto číslo dnes zapojené, ví jen operátor.
Druh patří k rozsahu, ne k lince, a zůstává stejný i při přechodu čísla k jinému operátorovi. Čísla internetové telefonie mohou vypadat jako pevné linky.
Omezení
Funguje pro všechny země a využívá data číslovacích plánů z open-source knihovny libphonenumber. Čísla zadaná bez + se čtou jako čísla země této edice. NoCall doplňuje nový španělský rozsah 400 a jeho čísla informací 118xx, která knihovna zatím nepopisuje.
Orientační informace ze zveřejněných číslovacích plánů. Popisuje druh čísla, nikdy osobu ani firmu, která za ním stojí.
Řešení potíží
U neplatného vstupu ověřte formát a zemi. Při chybě spojení zkuste znovu; při dosažení limitu dodržte čekací dobu.
Zadejte platné telefonní číslo nebo předvolbu.
Teď se to nepodařilo ověřit. Zkuste to prosím za chvíli znovu.
Použít přes API
Vyžaduje API klíč a kredity. Každé dokončené volání stojí 1 kredit, i když nejsou k dispozici žádná data. Aktivní účet Pro zahrnuje 20 kreditů na kalendářní měsíc UTC, sdílených všemi cestami API a čerpaných jako první; nevyčerpané měsíční kredity se nepřevádějí. Kredity zakoupené na stránce vašeho účtu fungují i bez Pro a nikdy nevyprší.
Chyby se nikdy neúčtují: 401 invalid_api_key (chybějící nebo neplatný klíč), 403 pro_required (žádné kredity Pro ani zakoupené kredity), 422 neplatný vstup, 429 quota_exceeded (žádné zbývající kredity), rate_limit_exceeded nebo ai_busy (AI pro sms-check je plně vytížená), 503 tool_warming (data se teprve připravují) nebo tool či poskytovatel nedostupný. Po odpovědi 429 nebo 503 to zkuste znovu, až uplyne počet sekund z hlavičky Retry-After.
Platnost, možnost, typ, země, mezinárodní předvolba a E.164 podle číslovacího plánu. Jakýkoli vstup, který vypadá jako telefonní číslo, je úspěšný výsledek: vrací se valid=false, nikdy chyba.
Pošli tělo JSON na vlastní cestu toolu, nebo na POST /v2/tools s přidaným polem tool. Obě cesty vrátí stejný výsledek.
POST https://api.nocall.io/v2/number-validator
POST https://api.nocall.io/v2/tools {"tool":"number-validator","phone":"+12025550123","country":"US"}Parametry
| Název | Typ | Povinný | Popis |
|---|---|---|---|
| phone | string (1–40) | Ano | Telefonní číslo ve formátu E.164 (+34…) nebo v národním formátu. |
| country | string (enum, 56) | Ne (výchozí: "ES") | Dvoupísmenný kód země, například ES nebo US, používaný pro národní vstup a pro data dané země. |
REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/number-validator' \
--header "Authorization: Bearer $NOCALL_API_KEY" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $REQUEST_ID" \
--data '{"phone":"+12025550123","country":"US"}'import json
import os
import urllib.request
import uuid
api_key = os.environ.get('NOCALL_API_KEY')
if not api_key:
raise SystemExit('Set NOCALL_API_KEY')
request = urllib.request.Request(
'https://api.nocall.io/v2/number-validator',
method='POST',
data=json.dumps({'phone': '+12025550123', 'country': 'US'}).encode(),
headers={
'Authorization': 'Bearer ' + api_key,
'Content-Type': 'application/json',
'Idempotency-Key': str(uuid.uuid4()),
},
)
with urllib.request.urlopen(request, timeout=30) as response:
result = json.load(response)
print(result['data']['result'], result['meta']['unitsCharged'])import { randomUUID } from 'node:crypto';
const requestId = randomUUID();
const apiKey = process.env.NOCALL_API_KEY;
if (!apiKey) throw new Error('Set NOCALL_API_KEY');
const response = await fetch('https://api.nocall.io/v2/number-validator', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + apiKey,
'Content-Type': 'application/json',
'Idempotency-Key': requestId,
},
body: JSON.stringify({ phone: '+12025550123', country: 'US' }),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code ?? 'request_failed');
console.log(result.data.result, result.meta.unitsCharged);Ukázková odpověď (200)
Jde o zdokumentovaný příklad z reference API. Vyhledávání používají smyšlené číslo a agregace i odpovědi AI ukazují tvar výsledku, ne živá data.
{
"data": {
"tool": "number-validator",
"result": {
"valid": true,
"possible": true,
"country": "US",
"callingCode": "1",
"type": "fixed_line_or_mobile",
"e164": "+12025550123"
}
},
"meta": {
"requestId": "req_example",
"unitsCharged": 1,
"usage": {
"periodStart": "2026-10-01",
"unitLimit": 20,
"unitsUsed": 3,
"unitsRemaining": 17
}
}
}Pole výsledku (data.result)
| Pole | Typ | Popis |
|---|---|---|
| valid | boolean | Zda je číslo platné podle číslovacího plánu. false je stále dokončený výsledek. |
| possible | boolean | Zda má číslo pro danou zemi možnou délku. |
| country | string | null | Země čísla (kód ISO), nebo null, pokud ji nelze určit. |
| callingCode | string | null | Mezinárodní předvolba země čísla, nebo null, pokud není známa. |
| type | string (enum, 14) | Typ čísla podle číslovacího plánu, například mobile, fixed_line, toll_free nebo premium_rate; unknown, pokud ho nelze zařadit. |
| e164 | string | null | Číslo ve formátu E.164, nebo null, pokud ho nelze naformátovat. |
Často kladené otázky
Co je formát E.164?
Je to mezinárodní standard zápisu čísla: znaménko plus, mezinárodní předvolba země a vnitrostátní číslo, bez mezer a bez úvodní nuly. Aplikace a telefonní systémy v něm čísla ukládají.
Znamená platné číslo, že se používá?
Ne. Platné znamená, že patří do rozsahu přiděleného v číslovacím plánu. Zda je právě toto číslo dnes zapojené, ví jen operátor.
Může se číslo změnit z mobilního na pevnou linku?
Druh patří k rozsahu, ne k lince, a zůstává stejný i při přechodu čísla k jinému operátorovi. Čísla internetové telefonie mohou vypadat jako pevné linky.
