本頁內容

目錄

國際區碼

API · Pro

涵蓋範圍: 地區資訊來自各站所屬國家的官方編碼計畫。西班牙為每個市話號碼區段列出了省份;許多其他國家列出了區碼和城市。任何國家的手機號碼都沒有地區,少數國家尚未公布我們能讀取的編碼計畫:對這些國家我們只顯示線路類型。

開啟工具
本頁內容

用途

僅提供格式和支援的區碼,不能證明號碼的位置、持有人或使用狀態。部分區碼由多個地區共用。

使用要求

任何 NoCall 帳號都可以閱讀這些指南。部分工具需要 Pro,各指南會註明。

使用步驟

  1. 選擇國家版本,開啟所需分類或項目,查看可用詳細資料。

  2. 國際電話區碼

  3. 國家

虛構範例

說明

此範例為虛構內容,並非真實查詢。請勿撥打電話或開啟其中的連結。

虛構範例
+1 · +44

理解結果

僅提供格式和支援的區碼,不能證明號碼的位置、持有人或使用狀態。部分區碼由多個地區共用。

限制

注意

僅提供格式和支援的區碼,不能證明號碼的位置、持有人或使用狀態。部分區碼由多個地區共用。

疑難排解

沒有符合的國家

透過 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 標頭中的秒數過後再重試。

依名稱、ISO 代碼或撥號代碼搜尋 ITU 國際冠碼,並提供在地化名稱。撥號代碼和 ISO 的完全相符結果排在最前。

將 JSON 主體傳送到該 tool 專屬的路由,或加上 tool 欄位後傳送到 POST /v2/tools。兩種路由回傳的結果相同。

端點
POST https://api.nocall.io/v2/calling-codes
POST https://api.nocall.io/v2/tools  {"tool":"calling-codes","query":"216","language":"en"}

參數

名稱類型必填說明
querystring (1–40)否要搜尋的國家名稱、ISO 代碼或國際冠碼。
languagestring (enum, 33)否 (預設: "en")國家名稱的語言。
bash
REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/calling-codes' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"query":"216","language":"en"}'

回應範例(200)

這是 API 參考文件中的範例。查詢使用虛構號碼,彙總資料和 AI 回答只呈現結果的結構,並非即時資料。

JSON
{
  "data": {
    "tool": "calling-codes",
    "result": {
      "rows": [
        {
          "code": "216",
          "name": "Tunisia",
          "territories": [
            "Tunisia"
          ],
          "source": "itu-e164-nnp-2026-08-09"
        }
      ],
      "total": 1
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

結果欄位(data.result)

欄位類型說明
rowsarray<object>相符的國際冠碼,附在地化名稱、地區和來源;撥號代碼和 ISO 的完全相符結果排在最前。
totalinteger符合條件的總列數。