داده‌های کد تماس در قالب JSON

شماره‌ها، کدهای تماس و کشورها را با اطمینان شناسایی کنید.

API مربوط به phonecode.app داده‌های ساختاریافته برای کدهای منطقه‌ای و بین‌المللی، شماره‌های خدمات و اضطراری و تبدیل شماره‌های محلی به قالب بین‌المللی ارائه می‌دهد. برای فروشگاه‌ها، سامانه‌های CRM، ابزارهای پشتیبانی، فرم‌های مشتریان بالقوه و کیفیت داده‌های داخلی طراحی شده است.

کلید ایجاد کنید شروع سریع

GET /api/search.php?q=030 JSON

{
  "ok": true,
  "query": "030",
  "results": [
    {
      "code": "030",
      "name": "Berlin",
      "region": "Deutschland",
      "kind": "Ort",
      "format": "+49 30"
    }
  ]
}

۲۸٬۶۰۸ رکوردها

۵٬۲۰۰ شبکه‌های محلی آلمان

۲۰۶ کشورها و سرزمین ها

۷۶ بازه‌های خدمات و اضطراری

۳۸۲ بازه‌های تلفن همراه

شروع سریع

اولین درخواست در چند دقیقه.

تأیید حساب

حساب مشتری بسازید و نشانی ایمیل خود را تأیید کنید.

کلید ایجاد کنید

یک کلید API بسازید. مقدار خوانای آن فقط یک بار نمایش داده می‌شود.

دریافت JSON

کلید را فقط به‌صورت Bearer Token در سرآیند Authorization بفرستید.

Bearer Token

curl "https://vorwahl.app/api/search.php?q=040" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

انتقال امن کلیدها

کلیدهای API نباید در URL، تاریخچه مرورگر، گزارش‌های پراکسی یا نشانی ارجاع‌دهنده قرار بگیرند. بنابراین پارامترهای پرس‌وجو پذیرفته نمی‌شوند.

نقاط پایانی

نقاط پایانی روشن JSON برای جستجو، حساب و صورتحساب.

GET

/api/search.php

کد تماس، شماره تلفن، مکان، کشور و شماره خدمات یا اضطراری را جستجو می‌کند.

پارامتر	توضیح
q	عبارت جستجو، مانند `030`، `Berlin`، `+44`، `0800`.
limit	اختیاری، از 1 تا 50 نتیجه. پیش‌فرض: 12.

GET

/api/internationalize.php

شماره محلی یک کشور را به قالب بین‌المللی قابل کپی تبدیل می‌کند.

پارامتر	توضیح
number	شماره محلی، مانند `0343 222 1234`.
country	کد ISO کشور شماره، مانند `GB`، `DE`، `AT`. پیش‌فرض: `DE`.

curl "https://vorwahl.app/api/internationalize.php?number=0343%20222%201234&country=GB" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

{
  "ok": true,
  "input": "0343 222 1234",
  "country": "GB",
  "international": "+44 343 222 1234"
}

GET

/api/health.php

وضعیت و شمارنده‌های فعلی داده را برمی‌گرداند.

GET

/api/billing/plans.php

بسته‌های API موجود، محدودیت‌ها و وضعیت PayPal را برمی‌گرداند.

POST

/api/account/api-keys.php

برای کاربران واردشده و تأییدشده کلید API ایجاد می‌کند.

قالب پاسخ

هر نتیجه داده‌های لازم برای نمایش، بررسی و قالب‌بندی را دارد.

codeکد تماس یا بازه شماره، مانند 030 یا +49.

nameمکان، کشور، خدمت یا عنوان اضطراری.

kindOrt, Land, Region, Dienst, Notruf.

local_formatقالب پیشنهادی نمایش ملی.

international_formatقالب پیشنهادی نمایش بین‌المللی.

adviceراهنمای قابل‌فهم درباره هزینه، استفاده یا روش شماره‌گیری.

برنامه های API

سهمیه‌های ماهانه قابل پیش‌بینی با استفاده رایگان منصفانه.

Das Lizenzangebot richtet sich ausschließlich an Unternehmen. Aufgrund der Kleinunternehmerregelung gemäß § 19 UStG wird keine Umsatzsteuer berechnet.