التوثيق

التوثيق ومرجع واجهة برمجة التطبيقات

كيفية استخدام ibanworld.de: التحقق من IBAN، البحث عن BIC، إيجاد بنك — بالإضافة إلى مرجع واجهة REST API الكامل مع أمثلة.

التحقق من IBAN

تحققوا مما إذا كان IBAN صحيحاً هيكلياً، وبالنسبة لأرقام IBAN الألمانية، اعثروا على البنك المطابق.

افتحوا أداة التحقق

انتقلوا إلى ibanworld.de — يوجد مربع التحقق أعلى الصفحة مباشرة.

أدخلوا أو الصقوا IBAN

تُحذف المسافات تلقائياً أثناء الكتابة، لذا يمكنكم لصق IBAN كما ورد من بنككم مباشرة.

اقرأوا النتيجة

ستشاهدون ما إذا كان رقم التحقق (MOD-97 وفق ISO 13616) صحيحاً، والدولة، وعضوية SEPA، وبالنسبة لأرقام IBAN الألمانية: اسم البنك وBIC والمدينة.

البحث عن BIC / رمز SWIFT

تحققوا من BIC موجود، أو استخدموا البحث بالاسم في الصفحة نفسها.

افتحوا بحث BIC

انتقلوا إلى ibanworld.de/bic-search.

تحققوا من BIC

أدخلوا رمز BIC من 8 أو 11 حرفاً (مثال: COBADEFFXXX) لرؤية تفكيك رمز البنك والدولة والموقع والفرع.

إيجاد بنك بالاسم

في الصفحة نفسها، استخدموا المربع الثاني للبحث عن البنوك الألمانية بالاسم أو رمز الفرز (Bankleitzahl) — 3 أحرف على الأقل.

مرجع الدول

تُدرج صفحة الدول جميع الدول الـ77 المدعومة مع طول IBAN وحالة SEPA ومثال IBAN يمكن تجربته مباشرة.

واجهة REST API — نظرة عامة

منطق التحقق نفسه الذي يشغّل الموقع متاح كواجهة REST API بصيغة JSON. لا حاجة لمفتاح API في الخطة المجانية.

الرابط الأساسي: https://ibanworld.de/api

حد الطلبات (الخطة المجانية): 5 طلبات لكل عنوان IP يومياً (بتوقيت UTC) عبر جميع نقاط /api/* مجتمعة. تتضمن كل استجابة رؤوس X-RateLimit-Limit وX-RateLimit-Remaining وX-RateLimit-Reset. لحد أعلى، تواصلوا معنا.

الصيغة: جميع الاستجابات بصيغة application/json.

POST /api/validate

يتحقق من IBAN. يقبل أيضاً GET /api/validate?iban=... للاختبار السريع في المتصفح.

الحقل	النوع	مطلوب	الوصف
iban	string	نعم	IBAN المراد التحقق منه. تُتجاهل المسافات.

POST/api/validate

curl

curl -X POST https://ibanworld.de/api/validate \
  -H "Content-Type: application/json" \
  -d '{"iban": "DE89370400440532013000"}'

response.json

{
  "valid": true,
  "iban": "DE89370400440532013000",
  "formatted": "DE89 3704 0044 0532 0130 00",
  "country": "Germany",
  "country_code": "DE",
  "sepa": true,
  "details": { "blz": "37040044", "account_number": "0532013000" },
  "bank": { "name": "Commerzbank", "bic": "COBADEFFXXX", "city": "Köln" }
}

GET /api/bic/{bic}

يتحقق من رمز BIC/SWIFT ويعيد البنك المطابق إن وُجد.

GET/api/bic/COBADEFFXXX

response.json

{
  "valid": true,
  "bank_code": "COBA",
  "country_code": "DE",
  "location_code": "FF",
  "branch_code": "XXX",
  "bank": { "name": "Commerzbank", "bic": "COBADEFFXXX", "city": "Köln" }
}

GET /api/banks/search?q=

يبحث عن البنوك الألمانية بالاسم أو رمز الفرز. 3 أحرف على الأقل؛ حتى 20 نتيجة.

الحقل	النوع	مطلوب	الوصف
q	string	نعم	مصطلح البحث (اسم البنك أو Bankleitzahl)، 3 أحرف على الأقل.

GET/api/banks/search?q=Commerzbank

response.json

{
  "results": [
    { "name": "Commerzbank", "blz": "37040044", "bic": "COBADEFFXXX", "city": "Köln" }
  ]
}

الأخطاء ورموز الحالة

422missing_iban — حقل iban فارغ أو غير مُرسَل.

200valid: false — طلب صحيح الصياغة لكنه غير صالح يعيد HTTP 200 مع حقل error يوضح السبب.

429rate_limit_exceeded — استنفدتم طلباتكم الخمسة المجانية لليوم. راجعوا X-RateLimit-Reset، أو تواصلوا معنا.