Na této stránce

Adresáře

Předvolby

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

Otevřete adresář své edice, zvolte kategorii a otevřete záznam. Počty popisují dostupná data NoCall, nikoli všechny hovory v zemi. Chybějící data nedokazují, že je číslo bezpečné.

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.

Jak používat

  1. Vyberte edici země, otevřete kategorii nebo řádek a prohlédněte dostupné podrobnosti.

  2. Číslo nebo předvolba

  3. Oblast

Smyšlený příklad

Poznámka

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

Smyšlený příklad
+34 · 91

Jak chápat výsledek

Mobilní čísla nejsou vázána na oblast: předvolba říká jen to, že jde o mobilní linku.

Tento rozsah není vázán na zeměpisnou oblast.

Omezení

Upozornění

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.

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

Řešení potíží

Tato předvolba není ve zveřejněném číslovacím plánu země této edice.

Číslovací plán této země teď nedokážeme načíst, takže umíme určit jen druh linky, ne oblast.

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.

Zveřejněné číselné rozsahy země, filtrovatelné podle třídy služby, cenové třídy a předvolby, stránkované. FR, DK, HK a SG nemají zveřejněný plán (422 s kódem detailu no_numbering_plan); CA vrací sdílený plán NANP.

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/prefix-directory
POST https://api.nocall.io/v2/tools  {"tool":"prefix-directory","country":"ES","serviceClass":"premium","page":1,"limit":3}

Parametry

NázevTypPovinnýPopis
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ě.
serviceClass"geographic" | "mobile" | "personal" | "toll_free" | "shared_cost" | "premium" | "mass_call" | "nomadic" | "m2m" | "internet" | "short_code" | "global_service" | "other"NePouze rozsahy této třídy služby.
costClass"free" | "standard" | "shared" | "premium" | "variable" | "unknown"NePouze rozsahy této cenové třídy.
querystring (1–20)NePouze rozsahy, jejichž předvolba začíná těmito číslicemi.
pageinteger (1–10000)Ne (výchozí: 1)Číslo stránky, počínaje 1.
limitinteger (1–100)Ne (výchozí: 50)Počet výsledků na stránku.
bash
REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/prefix-directory' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"country":"ES","serviceClass":"premium","page":1,"limit":3}'

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": "prefix-directory",
    "result": {
      "countryCode": "ES",
      "callingCode": "34",
      "planVersion": "ES-2021-02-18.review-2026-08-09",
      "total": 3,
      "page": 1,
      "limit": 3,
      "hasMore": false,
      "rows": [
        {
          "prefix": "803",
          "serviceClass": "premium",
          "costClass": "premium",
          "geography": null,
          "indexable": true,
          "source": "es-ministry-pnn-2021-02-18"
        },
        {
          "prefix": "806",
          "serviceClass": "premium",
          "costClass": "premium",
          "geography": null,
          "indexable": true,
          "source": "es-ministry-pnn-2021-02-18"
        },
        {
          "prefix": "807",
          "serviceClass": "premium",
          "costClass": "premium",
          "geography": null,
          "indexable": true,
          "source": "es-ministry-pnn-2021-02-18"
        }
      ]
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

Pole výsledku (data.result)

PoleTypPopis
countryCodestringZemě číslovacího plánu.
callingCodestringMezinárodní volací kód země.
planVersionstringVerze číslovacího plánu.
totalintegerCelkový počet odpovídajících řádků.
pageintegerAktuální stránka.
limitintegerPočet řádků na stránku.
hasMorebooleanZda po této stránce zbývají další řádky.
rowsarray<object>Číslovací rozsahy na této stránce: předvolba, třída služby, cenová třída, geografie a zdroj.