Na této stránce

Hovory a čísla

Ověření a formátování telefonního čísla

API · Pro

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ástroj
Na 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

  1. Otevřít nástroj

  2. 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.

  3. Zkontrolovat

  4. Č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

Poznámka

Smyšlený příklad, nikoli skutečný dotaz. Nevolejte ani neotevírejte jeho odkazy.

Smyšlený příklad
+44 1632 960123

Jak 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í

Upozornění

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

Upozornění

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ší.

Poznámka

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.

Endpoint
POST https://api.nocall.io/v2/number-validator
POST https://api.nocall.io/v2/tools  {"tool":"number-validator","phone":"+12025550123","country":"US"}

Parametry

NázevTypPovinnýPopis
phonestring (1–40)AnoTelefonní číslo ve formátu E.164 (+34…) nebo v národním formátu.
countrystring (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ě.
bash
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"}'

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.

JSON
{
  "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)

PoleTypPopis
validbooleanZda je číslo platné podle číslovacího plánu. false je stále dokončený výsledek.
possiblebooleanZda má číslo pro danou zemi možnou délku.
countrystring | nullZemě čísla (kód ISO), nebo null, pokud ji nelze určit.
callingCodestring | nullMezinárodní předvolba země čísla, nebo null, pokud není známa.
typestring (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.
e164string | 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.