目錄
區碼
涵蓋範圍: 地區資訊來自各站所屬國家的官方編碼計畫。西班牙為每個市話號碼區段列出了省份;許多其他國家列出了區碼和城市。任何國家的手機號碼都沒有地區,少數國家尚未公布我們能讀取的編碼計畫:對這些國家我們只顯示線路類型。
開啟工具本頁內容
用途
開啟所選版本的目錄,選擇分類並查看項目。數量表示 NoCall 中可用的資料,而非該國全部通話。缺少資料不能證明號碼安全。
使用要求
任何 NoCall 帳號都可以閱讀這些指南。部分工具需要 Pro,各指南會註明。
使用步驟
選擇國家版本,開啟所需分類或項目,查看可用詳細資料。
號碼或區碼
地區
虛構範例
此範例為虛構內容,並非真實查詢。請勿撥打電話或開啟其中的連結。
+34 · 91理解結果
手機號碼不與地區綁定:前綴只能說明這是手機線路。
此號碼區段不與地理區域綁定。
限制
地區資訊來自各站所屬國家的官方編碼計畫。西班牙為每個市話號碼區段列出了省份;許多其他國家列出了區碼和城市。任何國家的手機號碼都沒有地區,少數國家尚未公布我們能讀取的編碼計畫:對這些國家我們只顯示線路類型。
僅提供格式和支援的區碼,不能證明號碼的位置、持有人或使用狀態。部分區碼由多個地區共用。
疑難排解
此前綴不在本站所屬國家公布的編碼計畫中。
目前無法讀取該國的編碼計畫,因此只能判斷線路類型,無法判斷地區。
透過 API 使用
需要 API 金鑰和點數。每次完成的呼叫扣 1 點,即使沒有資料也一樣。有效的 Pro 帳戶每個 UTC 曆月包含 20 點,由所有 API 路由共用並優先扣用;當月未使用的點數不會累積到下個月。在帳戶頁面購買的點數不需 Pro 即可使用,且永不過期。
錯誤一律不扣點:401 invalid_api_key(缺少金鑰或金鑰無效)、403 pro_required(沒有 Pro 點數,也沒有購買的點數)、422 輸入無效、429 quota_exceeded(點數用完)、rate_limit_exceeded 或 ai_busy(sms-check 的 AI 已達負載上限)、503 tool_warming(資料仍在準備中)或 tool 或供應商無法使用。收到 429 或 503 後,請等 Retry-After 標頭中的秒數過後再重試。
某國已公布的編碼區段,可依服務類別、費用類別和前綴篩選,並分頁。FR、DK、HK 和 SG 沒有已公布的編碼計畫(回傳 422,details 代碼為 no_numbering_plan);CA 回傳共用的 NANP 編碼計畫。
將 JSON 主體傳送到該 tool 專屬的路由,或加上 tool 欄位後傳送到 POST /v2/tools。兩種路由回傳的結果相同。
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}參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
| country | string (enum, 56) | 否 (預設: "ES") | 雙字母國家代碼,例如 ES 或 US,用於國內格式輸入和該國資料。 |
| serviceClass | "geographic" | "mobile" | "personal" | "toll_free" | "shared_cost" | "premium" | "mass_call" | "nomadic" | "m2m" | "internet" | "short_code" | "global_service" | "other" | 否 | 只列出此服務類別的區段。 |
| costClass | "free" | "standard" | "shared" | "premium" | "variable" | "unknown" | 否 | 只列出此費用類別的區段。 |
| query | string (1–20) | 否 | 只列出前綴以這些數字開頭的區段。 |
| page | integer (1–10000) | 否 (預設: 1) | 頁碼,從 1 開始。 |
| limit | integer (1–100) | 否 (預設: 50) | 每頁結果數。 |
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);回應範例(200)
這是 API 參考文件中的範例。查詢使用虛構號碼,彙總資料和 AI 回答只呈現結果的結構,並非即時資料。
{
"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
}
}
}結果欄位(data.result)
| 欄位 | 類型 | 說明 |
|---|---|---|
| countryCode | string | 號碼編碼計畫所屬國家。 |
| callingCode | string | 該國的國際冠碼。 |
| planVersion | string | 號碼編碼計畫的版本。 |
| total | integer | 符合條件的總列數。 |
| page | integer | 目前頁碼。 |
| limit | integer | 每頁列數。 |
| hasMore | boolean | 此頁之後是否還有更多列。 |
| rows | array<object> | 此頁的編碼區段:前綴、服務類別、費用類別、地理資訊和來源。 |
