Adresáře
Předvolby
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ástrojNa 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
Vyberte edici země, otevřete kategorii nebo řádek a prohlédněte dostupné podrobnosti.
Číslo nebo předvolba
Oblast
Smyšlený příklad
Smyšlený příklad, nikoli skutečný dotaz. Nevolejte ani neotevírejte jeho odkazy.
+34 · 91Jak 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í
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
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.
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.
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ázev | Typ | Povinný | Popis |
|---|---|---|---|
| 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ě. |
| serviceClass | "geographic" | "mobile" | "personal" | "toll_free" | "shared_cost" | "premium" | "mass_call" | "nomadic" | "m2m" | "internet" | "short_code" | "global_service" | "other" | Ne | Pouze rozsahy této třídy služby. |
| costClass | "free" | "standard" | "shared" | "premium" | "variable" | "unknown" | Ne | Pouze rozsahy této cenové třídy. |
| query | string (1–20) | Ne | Pouze rozsahy, jejichž předvolba začíná těmito číslicemi. |
| page | integer (1–10000) | Ne (výchozí: 1) | Číslo stránky, počínaje 1. |
| limit | integer (1–100) | Ne (výchozí: 50) | Počet výsledků na stránku. |
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}'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/prefix-directory',
method='POST',
data=json.dumps({'country': 'ES', 'serviceClass': 'premium', 'page': 1, 'limit': 3}).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/prefix-directory', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + apiKey,
'Content-Type': 'application/json',
'Idempotency-Key': requestId,
},
body: JSON.stringify({ country: 'ES', serviceClass: 'premium', page: 1, limit: 3 }),
});
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": "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)
| Pole | Typ | Popis |
|---|---|---|
| countryCode | string | Země číslovacího plánu. |
| callingCode | string | Mezinárodní volací kód země. |
| planVersion | string | Verze číslovacího plánu. |
| total | integer | Celkový počet odpovídajících řádků. |
| page | integer | Aktuální stránka. |
| limit | integer | Počet řádků na stránku. |
| hasMore | boolean | Zda po této stránce zbývají další řádky. |
| rows | array<object> | Číslovací rozsahy na této stránce: předvolba, třída služby, cenová třída, geografie a zdroj. |
