來電與號碼
這個區碼是哪裡的?
涵蓋範圍: 地區資訊來自各站所屬國家的官方編碼計畫。西班牙為每個市話號碼區段列出了省份;許多其他國家列出了區碼和城市。任何國家的手機號碼都沒有地區,少數國家尚未公布我們能讀取的編碼計畫:對這些國家我們只顯示線路類型。
開啟工具本頁內容
用途
輸入號碼或前綴,查看它所屬的省份、城市或地區、線路類型以及撥打費用。
使用要求
任何 NoCall 帳號都可以閱讀這些指南。部分工具需要 Pro,各指南會註明。
輸入完整電話號碼或只輸入前幾碼。我們會在官方編碼計畫中查詢,告訴你它屬於哪個地區、是哪種線路,以及撥打通常要花多少錢。
使用步驟
開啟工具
輸入完整電話號碼或只輸入前幾碼。我們會在官方編碼計畫中查詢,告訴你它屬於哪個地區、是哪種線路,以及撥打通常要花多少錢。
檢查
配合限制說明閱讀可用欄位。空白結果不能證明安全,也不能確認個人身分。
虛構範例
此範例為虛構內容,並非真實查詢。請勿撥打電話或開啟其中的連結。
+44 1632 960123理解結果
配合限制說明閱讀可用欄位。空白結果不能證明安全,也不能確認個人身分。
不能。它告訴你的是號碼被分配到的地區。市話可以遷到別處,網路電話號碼可以在任何地方使用,所以它只是線索,而不是位置。
手機號碼區段是全國性的:前幾碼只說明這是手機線路,不說明在哪裡申辦,也不說明現在屬於哪家電信業者。
是的。它們來自該國主管機關或ITU公布的編碼計畫,並在計畫變更時更新。
限制
地區資訊來自各站所屬國家的官方編碼計畫。西班牙為每個市話號碼區段列出了省份;許多其他國家列出了區碼和城市。任何國家的手機號碼都沒有地區,少數國家尚未公布我們能讀取的編碼計畫:對這些國家我們只顯示線路類型。
參考資訊,來自公開的編碼計畫。它描述的是號碼類型,而不是號碼背後的個人或公司。
疑難排解
輸入無效時檢查格式和國家。連線出錯時重試;達到限制後請等待指定時間。
請輸入有效的電話號碼或號碼前綴。
目前無法檢查,請稍後再試。
透過 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 標頭中的秒數過後再重試。
前綴或號碼的歸屬:完全相符的編碼區段、最多 8 項建議、外國代碼,或無相符結果。
將 JSON 主體傳送到該 tool 專屬的路由,或加上 tool 欄位後傳送到 POST /v2/tools。兩種路由回傳的結果相同。
POST https://api.nocall.io/v2/prefix-origin
POST https://api.nocall.io/v2/tools {"tool":"prefix-origin","phone":"910","country":"ES"}參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
| phone | string (1–40) | 是 | E.164 或國內格式的電話號碼或前綴。 |
| country | string (enum, 56) | 否 (預設: "ES") | 雙字母國家代碼,例如 ES 或 US,用於國內格式輸入和該國資料。 |
REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/prefix-origin' \
--header "Authorization: Bearer $NOCALL_API_KEY" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $REQUEST_ID" \
--data '{"phone":"910","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/prefix-origin',
method='POST',
data=json.dumps({'phone': '910', '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/prefix-origin', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + apiKey,
'Content-Type': 'application/json',
'Idempotency-Key': requestId,
},
body: JSON.stringify({ phone: '910', 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);回應範例(200)
這是 API 參考文件中的範例。查詢使用虛構號碼,彙總資料和 AI 回答只呈現結果的結構,並非即時資料。
{
"data": {
"tool": "prefix-origin",
"result": {
"kind": "match",
"national": "910",
"row": {
"prefix": "910",
"serviceClass": "geographic",
"costClass": "standard",
"geography": "Madrid",
"indexable": true
},
"complete": false,
"planLoaded": true,
"numberType": null,
"foreignCode": null
}
},
"meta": {
"requestId": "req_example",
"unitsCharged": 1,
"usage": {
"periodStart": "2026-10-01",
"unitLimit": 20,
"unitsUsed": 3,
"unitsRemaining": 17
}
}
}結果欄位(data.result)
| 欄位 | 類型 | 說明 |
|---|---|---|
| kind | "foreign" | "match" | "suggestions" | "no_match" | 寄件者的種類。 |
| planLoaded | boolean | 是否有該國的號碼編碼計畫。 |
| numberType | string (enum, 14) | null | 號碼編碼計畫中的號碼類型,或 null。 |
| foreignCode | string | null | 輸入內容中找到的外國冠碼,或 null。 |
| national | string | 輸入中用於查詢的國內數字。 |
| row | object | 相符的編碼區段:前綴、服務類別、費用類別和地理區域。 |
| complete | boolean | 輸入是否已是該國完整有效的號碼,而不只是前綴。 |
| rows | array<object> | 輸入可能所屬的最多 8 個編碼區段。 |
| factsType | "mobile" | "landline" | "toll_free" | "premium" | null | 沒有相符的區段時,依該國號碼規則推斷的類型(mobile、landline、toll_free 或 premium),或 null。 |
常見問題
區碼能告訴我來電者在哪裡嗎?
不能。它告訴你的是號碼被分配到的地區。市話可以遷到別處,網路電話號碼可以在任何地方使用,所以它只是線索,而不是位置。
為什麼手機號碼沒有地區?
手機號碼區段是全國性的:前幾碼只說明這是手機線路,不說明在哪裡申辦,也不說明現在屬於哪家電信業者。
這些資訊是官方的嗎?
是的。它們來自該國主管機關或ITU公布的編碼計畫,並在計畫變更時更新。
