Hovory a čísla
Kolik stojí zavolat zpět?
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
Zadejte číslo, které vám volalo, a řekneme vám, o jaký druh čísla jde a kolik obvykle stojí zavolat zpět. Popisuje druh čísla, ne volajícího.
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
Číslo, které vám volalo
Zkontrolovat
Druh čísla
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
Orientačně: konečná cena závisí na operátorovi a tarifu.
Placená linka: Mnohem dražší než běžný hovor; cenu za minutu určuje služba a není v tarifu.
Informace o číslech (118xx): Vysoký poplatek za spojení i minutu; mohou vás přepojit a dál účtovat.
Sdílené náklady: Platíte část hovoru; mnoho tarifů ho nezahrnuje.
Bezplatná linka: Zdarma z pevné i mobilní sítě.
Satelitní nebo globální síť: Patří k nejvyšším cenám za minutu.
Mezinárodní předvolba s vysokým tarifem: Předvolba častá v mezinárodních kampaních prozvonění (wangiri). Účtuje se jako mezinárodní a může být drahá.
Mezinárodní: Operátor účtuje jako mezinárodní hovor.
Vnitrostátní pevná nebo mobilní: Jako vnitrostátní hovor; obvykle v tarifu.
Nerozpoznáno: Nedokážeme ho zařadit. Před voláním si ověřte cenu u operátora.
Omezení
Orientačně: konečná cena závisí na operátorovi a tarifu.
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.
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
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.
Cenová úroveň zpětného volání na číslo (prémiové, sdílené náklady, zdarma, mezinárodní, satelitní, wangiri, …) a odpovídající rozsah z registru.
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/callback-cost
POST https://api.nocall.io/v2/tools {"tool":"callback-cost","phone":"806123456","country":"ES"}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/callback-cost' \
--header "Authorization: Bearer $NOCALL_API_KEY" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $REQUEST_ID" \
--data '{"phone":"806123456","country":"ES"}'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/callback-cost',
method='POST',
data=json.dumps({'phone': '806123456', 'country': 'ES'}).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/callback-cost', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + apiKey,
'Content-Type': 'application/json',
'Idempotency-Key': requestId,
},
body: JSON.stringify({ phone: '806123456', country: 'ES' }),
});
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": "callback-cost",
"result": {
"tier": "premium",
"scope": "national",
"callingCode": null,
"registry": {
"prefix": "806",
"serviceClass": "premium",
"costClass": "premium",
"geography": null,
"indexable": true
}
}
},
"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 |
|---|---|---|
| tier | string (enum, 9) | Cenová úroveň zpětného volání na číslo. |
| scope | "national" | "international" | Zda je číslo národní, nebo mezinárodní. |
| callingCode | string | null | Mezinárodní volací kód, nebo null u národního čísla. |
| registry | object | null | Odpovídající číslovací rozsah z registru, nebo null. |
