來電與號碼
電話號碼驗證與格式化
涵蓋範圍: 適用於所有國家，使用開源函式庫libphonenumber的編碼計畫資料。未加+輸入的號碼會視為本站所屬國家的號碼。NoCall補充了西班牙新的400號碼區段和118xx查號號碼，該函式庫目前尚未收錄。
開啟工具本頁內容
用途
檢查電話號碼是否有效，是手機、市話、免付費號碼還是加值付費號碼，並以E.164、國內和國際格式顯示。
使用要求
任何 NoCall 帳號都可以閱讀這些指南。部分工具需要 Pro，各指南會註明。
貼上任何電話號碼，檢查它是否有效、屬於哪類號碼，以及如何用E.164、國內和國際格式書寫。
使用步驟
開啟工具
貼上任何電話號碼，檢查它是否有效、屬於哪類號碼，以及如何用E.164、國內和國際格式書寫。
檢查
配合限制說明閱讀可用欄位。空白結果不能證明安全，也不能確認個人身分。
虛構範例
此範例為虛構內容，並非真實查詢。請勿撥打電話或開啟其中的連結。
+44 1632 960123理解結果
配合限制說明閱讀可用欄位。空白結果不能證明安全，也不能確認個人身分。
這是書寫號碼的國際標準：加號、國碼和國內號碼，不含空格，也沒有開頭的0。應用程式和電話系統用它來儲存號碼。
不是。有效表示它屬於編碼計畫中已分配的號碼區段。這個號碼今天是否已開通，只有電信業者知道。
類型屬於號碼區段，而不屬於線路，號碼轉到其他電信業者時類型保持不變。網路電話號碼可能看起來像市話。
限制
適用於所有國家，使用開源函式庫libphonenumber的編碼計畫資料。未加+輸入的號碼會視為本站所屬國家的號碼。NoCall補充了西班牙新的400號碼區段和118xx查號號碼，該函式庫目前尚未收錄。
參考資訊，來自公開的編碼計畫。它描述的是號碼類型，而不是號碼背後的個人或公司。
疑難排解
輸入無效時檢查格式和國家。連線出錯時重試；達到限制後請等待指定時間。
請輸入有效的電話號碼或號碼前綴。
目前無法檢查，請稍後再試。
透過 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 標頭中的秒數過後再重試。
依編碼計畫提供有效性、可能性、類型、國家、國碼和 E.164。任何看似電話號碼的輸入都是成功的結果：回傳 valid=false，而不是錯誤。
將 JSON 主體傳送到該 tool 專屬的路由，或加上 tool 欄位後傳送到 POST /v2/tools。兩種路由回傳的結果相同。
POST https://api.nocall.io/v2/number-validator
POST https://api.nocall.io/v2/tools {"tool":"number-validator","phone":"+12025550123","country":"US"}參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
| phone | string (1–40) | 是 | E.164（+34…）或國內格式的電話號碼。 |
| country | string (enum, 56) | 否 (預設: "ES") | 雙字母國家代碼，例如 ES 或 US，用於國內格式輸入和該國資料。 |
REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/number-validator' \
--header "Authorization: Bearer $NOCALL_API_KEY" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $REQUEST_ID" \
--data '{"phone":"+12025550123","country":"US"}'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/number-validator',
method='POST',
data=json.dumps({'phone': '+12025550123', 'country': 'US'}).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/number-validator', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + apiKey,
'Content-Type': 'application/json',
'Idempotency-Key': requestId,
},
body: JSON.stringify({ phone: '+12025550123', country: 'US' }),
});
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": "number-validator",
"result": {
"valid": true,
"possible": true,
"country": "US",
"callingCode": "1",
"type": "fixed_line_or_mobile",
"e164": "+12025550123"
}
},
"meta": {
"requestId": "req_example",
"unitsCharged": 1,
"usage": {
"periodStart": "2026-10-01",
"unitLimit": 20,
"unitsUsed": 3,
"unitsRemaining": 17
}
}
}結果欄位（data.result）
| 欄位 | 類型 | 說明 |
|---|---|---|
| valid | boolean | 號碼在編碼計畫中是否有效。false 仍是完成的結果。 |
| possible | boolean | 號碼長度對該國而言是否可能。 |
| country | string | null | 號碼所屬國家（ISO 代碼）；無法判定時為 null。 |
| callingCode | string | null | 號碼所屬國家的國碼；未知時為 null。 |
| type | string (enum, 14) | 編碼計畫中的號碼類型，例如 mobile、fixed_line、toll_free 或 premium_rate；無法分類時為 unknown。 |
| e164 | string | null | E.164 格式的號碼；無法格式化時為 null。 |
常見問題
什麼是E.164格式？
這是書寫號碼的國際標準：加號、國碼和國內號碼，不含空格，也沒有開頭的0。應用程式和電話系統用它來儲存號碼。
號碼有效是否代表正在使用？
不是。有效表示它屬於編碼計畫中已分配的號碼區段。這個號碼今天是否已開通，只有電信業者知道。
號碼會從手機變成市話嗎？
類型屬於號碼區段，而不屬於線路，號碼轉到其他電信業者時類型保持不變。網路電話號碼可能看起來像市話。