الرئيسية
خدمة العملاءEnglish
المطورون · حزم SDK

ابنِ مع BINK.

استخدم BINK API باللغة التي يعرفها فريقك بالفعل — عميل TypeScript مولَّد من مواصفة OpenAPI، ومواصفة يمكنك توليد أي لغة منها، أو REST مباشرةً في الأساس.

اقرأ مرجع APIافتح بيئة الاختبار
REST · JSONمواصفة OpenAPIعميل TypeScript
الطلب
curl https://binkpay.net/api/v1/developer/ping \
  -H "Authorization: Bearer sk_test_51H..."
الاستجابة200 OK
{
  "ok": true,
  "companyId": "co_4b7e21",
  "livemode": false,
  "scopes": ["analytics:read", "payments:read"]
}

نقطة فحص المطور — نقطة النهاية الوحيدة التي تقبل مفتاح API اليوم. للعرض والنسخ فقط؛ لا يُرسل أي طلب فعلي.

كيف تتكامل

ثلاثة مسارات واضحة.

لا تنشر BINK حزمًا لكل لغة. هذا ما هو متاح فعليًا اليوم.

مولَّد من المواصفة

TypeScript / Node

BinkpayClient بلا أي تبعيات، مولَّد من مواصفة OpenAPI الخاصة بالـ API ومحدد الأنواع بالكامل. يُستورد من الكود المصدري، وليس حزمة من سجل حزم.

ولّده من المواصفة

أي لغة

لا توجد بعد حزمة رسمية للغات الأخرى. ولّد عميلًا للغتك من مواصفة OpenAPI نفسها باستخدام openapi-generator.

متاح الآن

REST API

لا حاجة إلى SDK. الـ API عبارة عن REST بسيط عبر HTTPS، وJSON في الطلب والاستجابة — استدعه بالأدوات التي يستخدمها فريقك بالفعل.

عميل TypeScript

محدد الأنواع، ومولَّد من المواصفة.

عميل TypeScript مولَّد من مواصفة OpenAPI الخاصة بالـ API، لذا تتبع دواله وأنواعه الـ API. لا يحمل أي تبعيات ويستخدم fetch المدمجة في المنصة. أنشئه بمفتاحك؛ وسيرسل المفتاح كرمز Bearer.

TypeScript
import { BinkpayClient } from "./sdk/typescript";

// Zero-dependency, generated from the OpenAPI spec.
const binkpay = new BinkpayClient({
  apiKey: "sk_test_51H...",
});
قبل أول استدعاء

المصادقة والبيئات.

المصادقة

تعتمد BINK في التفويض على الجلسة + مفتاح API. يعمل مفتاح sk_ اليوم على نقطة فحص المطور؛ أما نقاط نهاية الموارد فتعتمد على جلسة لوحة التحكم. أرسل المفتاح كرمز Bearer.

توثيق المصادقة

البيئات

لكل حساب زوج للاختبار (sk_test_) وزوج للتشغيل الفعلي (sk_live_). يحمل المفتاح الوضع — عنوان URL الأساسي نفسه /api/v1، دون مضيف منفصل لتبديله.

توثيق البيئات
المسار الموصى به

من المفتاح إلى الإنتاج.

  1. المصادقة

    أرسل مفتاحك كرمز Bearer؛ كل استجابة تحمل requestId.

  2. أنشئ طلبًا

    REST عبر HTTPS، ومتن JSON، وبادئة واحدة — ‎/api/v1.

  3. تعامل مع الاستجابة

    شكل واحد يمكن التنبؤ به وغلاف أخطاء واحد لكل الموارد.

  4. استمع إلى Webhooks

    تحقق من توقيع كل حدث واستجب له — دون استطلاع متكرر.

  5. انتقل إلى الإنتاج

    استبدل مفتاح sk_test_ بـ sk_live_. لا يوجد عنوان URL أساسي لتغييره.

قائم على الأحداث، لا على الاستطلاع.

تتيح أحداث Webhooks لنظامك الاستجابة للتغييرات دون استطلاع متكرر. كل عملية تسليم موقّعة بـ HMAC-SHA256 — تحقق منها واستجب.

استكشف Webhooks
بوابة المطورين

بقية المنصة.

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

ابدأ بالمرجع.

نقاط النهاية بدقة، وشكل الطلب، وغلاف الأخطاء — ثم ولّد عميلًا، أو استدعِ الـ API مباشرةً.

اقرأ مرجع APIافتح بيئة الاختبار