Na této stránce

Hovory a čísla

Formáty telefonních čísel

API · Pro

Pokrytí: Oblasti pocházejí z oficiálního číslovacího plánu země každé edice. Španělsko uvádí provincii pro každý rozsah pevných linek; mnoho dalších zemí uvádí své předvolby a města. Mobilní čísla nemají oblast v žádné zemi a několik zemí zatím nezveřejňuje plán, který bychom mohli načíst: tam ukazujeme jen druh linky.

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.

Zadejte celé číslo s mezinárodní předvolbou. U národního čísla nejprve ověřte zemi edice nebo výběru.

Jak používat

  1. Formáty telefonních čísel

  2. Zadejte celé číslo s mezinárodní předvolbou. U národního čísla nejprve ověřte zemi edice nebo výběru.

  3. Zkontrolovat

  4. E.164 · Bez mezinárodní předvolby · Mezinárodní formát

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

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

Omezení

Upozornění

Pouze formáty a podporované předvolby. Nepotvrzují polohu, majitele ani aktivitu čísla. Některé předvolby jsou sdílené.

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

Neplatné telefonní číslo

Bezpečnostní kontrola nebo připojení k API neodpovědělo včas. Zkuste to znovu za pár sekund.

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.

Formát E.164, národní a mezinárodní formát, mezinárodní předvolba, země a platnost podle číslovacího plánu. Možné, ale nepřidělené číslo vrací valid=false.

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/phone-formats
POST https://api.nocall.io/v2/tools  {"tool":"phone-formats","phone":"+34912345678","country":"ES"}

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/phone-formats' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"phone":"+34912345678","country":"ES"}'

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": "phone-formats",
    "result": {
      "e164": "+34912345678",
      "national": "912 34 56 78",
      "international": "+34 912 34 56 78",
      "callingCode": "34",
      "country": "ES",
      "valid": true
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

Pole výsledku (data.result)

PoleTypPopis
e164stringČíslo ve formátu E.164, nebo null, pokud ho nelze naformátovat.
nationalstringČíslo v národním formátu jeho země.
internationalstringČíslo v mezinárodním formátu.
callingCodestringMezinárodní předvolba země čísla, nebo null, pokud není známa.
countrystring | nullZemě čísla (kód ISO), nebo null, pokud ji nelze určit.
validbooleanZda je číslo platné podle číslovacího plánu. false je stále dokončený výsledek.