المهارات plaid-fintech
📦

plaid-fintech

آمن

دمج Plaid API لبيانات الخدمات المصرفية والمدفوعات

يتطلب بناء تطبيقات التكنولوجيا المالية أنماط دمج آمنة لـ Plaid API. توفر هذه المهنة نهجاً مجربة لتدفقات رمز Link، ومزامنة المعاملات، والتعامل مع webhooks، ومتطلبات الامتثال.

يدعم: Claude Codex Code(CC)
📊 71 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "plaid-fintech". يريد المستخدم تنفيذ إنشاء رمز Plaid Link

النتيجة المتوقعة:

إنشاء كود نقطة نهاية من جانب الخادم لـ /create_link_token مع تكوين المنتج المناسب (auth، transactions، identity)، وتهيئة Plaid Link من جانب العميل بالرمز المرتجع، ومعالج الاستدعاء لتبادل public_token

استخدام "plaid-fintech". التعامل مع خطأ ITEM_LOGIN_REQUIRED أثناء جلب المعاملات

النتيجة المتوقعة:

اكتشاف ITEM_LOGIN_REQUIRED في استجابة API، وضع علامة على حساب المستخدم بأنه يحتاج إلى إعادة مصادقة، وعرض رمز update_link للعميل، وإرشاد المستخدم خلال وضع تحديث Link دون فقدان البيانات التاريخية

التدقيق الأمني

آمن
v1 • 2/24/2026

Static analyzer flagged 5 patterns as potential security issues, but all are false positives. The 'weak cryptographic algorithm' matches are triggered by the word 'verification' in documentation text describing Plaid API features. The 'system reconnaissance' matches are triggered by 'link_token' which is a legitimate Plaid API concept for OAuth-style bank connections. This skill contains only documentation with no executable code, making it safe for publication.

1
الملفات التي تم فحصها
55
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
31
المجتمع
100
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

إعداد بدء تشغيل التكنولوجيا المالية

يحتاج المطور الذي يبني تطبيقاً للتمويل الشخصي إلى ربط الحسابات المصرفية للمستخدمين بشكل آمن. استخدم هذه المهنة لتنفيذ تدفق رمز Link والتعامل مع أخطاء المصادقة برقة.

دمج تطبيق الدفع

تريد منصة التجارة الإلكترونية تمكين مدفوعات ACH. استخدم هذه المهنة لتنفيذ التحقق من Auth والتعامل مع أخطاء ITEM_LOGIN_REQUIRED أثناء إعداد الدفع.

أداة تحليل المعاملات

يحتاج تطبيق الميزانية إلى مزامنة فعالة للمعاملات دون استدعاءات API زائدة عن الحاجة. استخدم هذه المهنة لتنفيذ /transactions/sync والتحديثات المستندة إلى webhook بدلاً من الاستطلاع.

جرّب هذه الموجهات

إعداد رمز Link الأساسي
أحتاج إلى تنفيذ Plaid Link في تطبيقي. أظهر لي التدفق لإنشاء link_token من جانب الخادم، وعرضه للمستخدمين، وتبادل public_token مقابل access_token.
تنفيذ مزامنة المعاملات
ساعدني في تنفيذ جلب فعال للمعاملات باستخدام /transactions/sync بدلاً من /transactions/get. أظهر كيفية التعامل مع المؤشر للتحديثات التدريجية واكتشاف متى يلزم التحديث الكامل.
تصميم معالج Webhook
صمم معالج webhook لـ Plaid webhooks. ركز على أحداث ITEM_LOGIN_REQUIRED و PENDING_DISCONNECT. أظهر كيفية إخطار المستخدمين بشكل استباقي وإرشادهم خلال وضع التحديث.
استراتيجية التعامل مع الأخطاء
أنشئ استراتيجية شاملة للتعامل مع الأخطاء لدمج Plaid API. غطّ أخطاء Item وأخطاء API والرسائل الموجهة للمستخدم. تضمن منطق إعادة المحاولة ومتى تطلب من المستخدمين إعادة ربط الحسابات.

أفضل الممارسات

  • تخزين access_tokens مشفرة أثناء الراحة باستخدام خدمات إدارة المفاتيح الأساسية للمنصة
  • استخدام webhooks للتحديثات في الوقت الفعلي بدلاً من الاستطلاع لتقليل استدعاءات API
  • التعامل مع webhooks PENDING_DISCONNECT بشكل استباقي لتقليل احتكاك المستخدم

تجنب

  • تخزين رموز الوصول كنص عادي أو في تخزين من جانب العميل
  • الاستطلاع المتكرر لـ /transactions/get بدلاً من استخدام /transactions/sync مع webhooks
  • تجاهل أخطاء Item التي يمكن أن تؤدي إلى بيانات قديمة وتجارب مستخدم معطلة

الأسئلة المتكررة

هل تنتهي صلاحية رموز Link؟
نعم، رموز Link قصيرة العمر (عادة 30 دقيقة) وتستخدم لمرة واحدة. أنشئ رمزاً جديداً في كل مرة يحتاج فيها المستخدم إلى ربط حساب أو تحديث بيانات الاعتماد.
هل تنتهي صلاحية رموز الوصول؟
رموز الوصول لا تنتهي صلاحيتها افتراضياً. ومع ذلك، قد تصبح غير صالحة إذا غيّر المستخدمون بيانات اعتمادهم المصرفية. استمع لأخطاء ITEM_LOGIN_REQUIRED لاكتشاف متى يلزم إعادة المصادقة.
ما الفرق بين /transactions/get و /transactions/sync؟
استخدم /transactions/sync للتحديثات التدريجية مع ترقيم الصفحات القائم على المؤشر. يعيد فقط المعاملات الجديدة أو المعدلة أو المحذوفة منذ آخر مزامنة. /transactions/get يعيد جميع المعاملات وهو أقل كفاءة للتحديثات المنتظمة.
كيف أتعامل مع أمان webhook؟
تحقق من توقيعات webhook باستخدام مفتاح التحقق من Plaid. تحقق من صحة بنية حمولة webhook وتأكد من أن نقطة النهاية HTTPS فقط. تعامل مع webhooks بشكل غير متزامن لتجنب مشاكل المهلة.
ما المنتجات التي يجب تفعيلها لرموز Link؟
فعّل فقط المنتجات التي تستخدمها بنشاط. التركيبات الشائعة: auth (للتحقق من ACH)، transactions (لسجل المعاملات)، identity (للتحقق من حامل الحساب). كل منتج مفعّل يؤثر على التسعير.
كيف أختبر دمج Plaid دون حسابات مصرفية حقيقية؟
استخدم بيئة Plaid Sandbox مع بيانات اعتماد اختبار. يوفر Sandbox حسابات اختبار حتمية مع سلوكيات قابلة للتحكم مثل حالات القطع المعلقة، وأخطاء Item، وأنماط معاملات محددة.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md