الرئيسية
خدمة العملاءEnglish
المطورون · سجل التغييرات

ما الذي تغيّر في BINK.

التغييرات على الـ API وWebhooks ومنصة المطورين، الأحدث أولًا. كل إدخال مؤرَّخ بتاريخ التغيير الذي أطلقه.

إصدار API
v2
المدعوم
v2 · v1 (متقادم)

  1. نقل الملفات المرفوعة إلى تخزين كائنات دائم

    الملفات المرفوعة عبر الـ API — ولا سيما وثائق الهوية — تُخزَّن الآن في تخزين كائنات دائم خلف خدمة تخزين واحدة، ولا تُقدَّم إلا عبر مسارات مصرّح بها.

    • تغيّرمسارات رفع وثائق KYC واسترجاعها تمر الآن عبر خدمة التخزين؛ ولم يعد الوصول إلى الوثائق ممكنًا من مسار رفع عام.

  2. نقطة نهاية لإحصاءات المدفوعات

    نقطة نهاية مخصصة تعيد مجاميع المدفوعات لكل عملة للوحة تحكم التاجر، وتُحسب في قاعدة البيانات بدلًا من جهة العميل.

    • أُضيفGET /merchant/payments/stats — الإجماليات والأعداد لكل عملة لعرض المدفوعات.
    مرجع المدفوعات

  3. بطاقات الشركة، والتمويل، وحالة كل خدمة

    يمكن لحسابات الأعمال تمويل بطاقات الشركة من رصيدها، وأصبح فحص حالة الـ API يُبلغ عن حالة كل خدمة بدلًا من مؤشر واحد.

    • أُضيفبطاقات الشركة — POST /merchant/company-cards للإصدار، وPOST /merchant/company-cards/:id/fund للشحن من رصيد التاجر.
    • أُضيفمسارات تمويل لنقل الرصيد بين المحافظ وبطاقات الشركة.
    • تغيّرتُجمَّع تحليلات التاجر حسب العملة بدلًا من جمعها عبر العملات.
    • تغيّريُبلغ GET /health عن حالة كل خدمة (التسوية، وصرف العملات، والتحقق من الهوية، والإشعارات، ودفتر الأستاذ، والمطابقة وغيرها)، وهو ما تقرؤه صفحة الحالة الآن.
    حالة الأنظمة

  4. منصة المطورين: مفاتيح API، وإدارة الإصدارات، وOpenAPI، وبيئة الاختبار

    أول طبقة من المنصة موجهة للمطورين: مفاتيح API محددة النطاق، وترويسة لإصدار الـ API، ومواصفة قابلة للقراءة آليًا، وبيئة اختبار لمحاكاة الأحداث.

    • أُضيفمفاتيح API بالبادئات sk_ / pk_ و_test / _live، محددة النطاق لكل مورد، مع تسجيل الطلبات لكل مفتاح.
    • أُضيفإدارة إصدارات الـ API — ترويسة X-Api-Version؛ الإصدار v2 هو الحالي، وv1 لا يزال مدعومًا لكنه متقادم.
    • أُضيفGET /developer/openapi.json — مستند OpenAPI 3.0 مولَّد — وGET /developer/versions.
    • أُضيفGET /developer/ping وPOST /developer/sandbox/:kind — نقطة الفحص المصادَق عليها بمفتاح API ومحاكي الأحداث لمفاتيح الاختبار.
    • أُضيفنقاط نهاية الحالة — GET /health و/health/live و/health/ready.
    المصادقة مرجع API

  5. المنصة الأولى

    أُطلقت واجهة REST API للتجار وWebhooks الموقّعة وغلاف الأخطاء الموحّد معًا في الإصدار الأول.

    • أُضيفواجهة API للتجار — المدفوعات والتحويلات الصادرة والمبالغ المستردة والعملاء والفواتير تحت ‎/merchant.
    • أُضيفWebhooks صادرة موقّعة بـ HMAC-SHA256 في ترويسة X-Binkpay-Signature، مع إعادة المحاولة وحالة للرسائل غير المسلَّمة (dead-letter).
    • أُضيفغلاف أخطاء واحد عبر الـ API — ok وstatusCode وmessage وrequestId وtimestamp.
    مرجع Webhooks مرجع الأخطاء

تغطي الإدخالات الواجهة الموجهة للمطورين فقط. والتواريخ هي تواريخ دمج التغيير في الفرع الرئيسي.

بوابة المطورين

بقية المنصة.

مرجع APIموارد REST وعقد الطلب والاستجابة.حزم SDKعملاء مكتوبون بأنواع بيانات صريحة للـ API.بيئة الاختبارمفاتيح اختبار وأحداث محاكاة، معزولة عن الإنتاج.Webhooksتسليم أحداث موقّعة، مع إعادة المحاولة وإعادة الإرسال.التوثيقأدلة وبدايات سريعة وأنماط تكامل.حالة APIالحالة المباشرة للأنظمة.سجل التغييرات ·ملاحظات الإصدارات والتغييرات الجذرية.