بيانات رموز الاتصال بصيغة 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.