مخطط التكامل بدون كود

تدفق الترقيم الدولي

Method: GET
URL: https://api.isvalid.dev/v0/isin?value={{isin_input}}
Headers:
  Accept: application/json
  User-Agent: [your-app]/1.0
  Authorization: Bearer {{ISVALID_API_KEY}}
Rate Limit: according to your API plan

• التحقق من صحة التنسيق المحلي قبل استدعاء واجهة برمجة التطبيقات: 12 حرفًا بالضبط.
• في الإنتاج، قم بتكوين مفتاح API في البيئة (ISVALID_API_KEY).
• إذا كان صالحًا، فاستخرج fisin وcfi_code والعملة وlei وfigi.
• إذا كان 429، قم بتطبيق الإجراء الاحتياطي وإعادة المحاولة الأسية.

تدفق سويفت/بيك

Method: GET
URL: https://api.isvalid.dev/v0/bic?value={{bic_input}}
Headers:
  Accept: application/json
  Authorization: Bearer {{ISVALID_API_KEY}}
Regex BIC: /^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$/

• يؤدي التنسيق غير الصالح إلى إرجاع خطأ فوري.
• يستعلم التنسيق الصالح عن واجهة برمجة التطبيقات (API) ويؤكد المؤسسة والبلد والمدينة.
• الحالة النهائية: تم تأكيد BIC أو لم يتم العثور على BIC.

تدفق SBLC / DLC

• لا توجد واجهة برمجة تطبيقات عامة مجانية موثوقة للتحقق المباشر.
• إجراء التحقق غير المباشر: جهة الإصدار BIC بالإضافة إلى قائمة البنوك المراسلة الموثوقة.
• افتح المهمة اليدوية للتأكيد عبر قناة SWIFT الرسمية (MT799/MT760/MT767).

مخزن البيانات المقترح

{
  "id": "uuid",
  "tipo_documento": "ISIN|SWIFT|SBLC|DLC",
  "valor_documento": "string",
  "status_validacao": "PENDENTE|VALIDO|INVALIDO|ERRO|MANUAL",
  "data_validacao": "timestamp",
  "fonte_validacao": "isvalid|swiftref|manual",
  "dados_resposta": {"json_original": "{}"},
  "flags": {"alerta_fraude": true, "requer_acao_manual": false}
}

إعادة المحاولة، الأمان والامتثال

• إعادة المحاولة: 3 محاولات مع التراجع الأسي (1 ثانية، 2 ثانية، 4 ثانية) لـ 500/502/503/429.
• استخدم HTTPS، وقم بتطهير المدخلات وفرض حد المعدل بواسطة المستخدم/IP.
• لا تقم بتسجيل المستندات الحساسة بنص عادي.
• LGPD/GDPR: الموافقة، وفترة الاحتفاظ، وسير عمل التصدير والحذف.