انتقل إلى المحتوى
التكاملات

REST API من بيسكي.

يوفّر بيسكي واجهة REST API ‏(v1) لتجّار التجزئة والمنصات الراغبين في الربط المباشر.
واجهة REST ↔ بيسكي
  • المنتجات والأسماء والصورمن واجهة REST
  • الأسعار والمخزونتحديث منتظم
  • أسماء عربية وتهجئاتيضيفها بيسكي
  • طلب #7342 · 94.00 ر.سإلى واجهة طلباتك
المزامنة

ما يُزامَن، وإلى أين يذهب الطلب.

وارد · من واجهة REST
REST API v1فرع العليا
POST /v1/products {"sku":"PRM-200","name":"Parmigiano Reggiano 200g","price":4.79,"stock":42}
يجهّزه بيسكي
بارميجانو 200 غأجبان · صلبة18.00 ر.س
parmesanparmigianoبارميزان
متوفر في العليا · 42
صادر · الطلب المؤكّد
الطلب #7342عشاء باستا لـ 4 · 9 منتجات94.00 ر.س
  • سباغيتي11.00 ر.س
  • صلصة طماطم9.75 ر.س
  • ثوم3.75 ر.س
  • + 4 أسطر أخرى
{ }Webhook: order.confirmedإلى عنوانك، موقّع
الإعداد

الربط في ثلاث خطوات.

  1. 01

    احصل على مفاتيح API

    يُصدر فريقك المفاتيح لحساب منشأتك كمتجر.

    sk_live_••••••••متصل
  2. 02

    أرسل كتالوجك

    المنتجات وأسعار الفروع ومخزونها، ثم تحديثات التغييرات عند حدوثها.

    4,812منتج · 3 فروع
  3. 03

    استقبل الطلبات

    اشترك في إشعارات الويب أو اضبط بيسكي ليرسل إلى API الطلبات لديك.

    48/48اختبارات على منتجاتكمباشر
للمطوّرين

الواجهة في طلبين.

أرسل المنتجات بمفتاح منع التكرار، واستقبل كل طلب مؤكّد كـ webhook موقّع.

ترسلproducts
POST /v1/products
 
Authorization: Bearer sk_live_••••
Idempotency-Key: 6f1c2e0a
 
{
"sku": "PRM-200",
"name": "Parmigiano Reggiano 200g",
"branch": "al-olaya", "price": 18.00, "stock": 42
}
تستقبلwebhook
POST https://your-store.example/bisky/orders
 
X-Bisky-Event: order.confirmed
X-Bisky-Signature: t=…,v1=…
 
{
"order": "7342",
"branch": "al-olaya",
"lines": 7, "items": 9,
"total": { "amount": 94.00, "currency": "SAR" }
}

شكل توضيحي. المخطط الكامل في وثائق الواجهة.

داخل تطبيقك

يسأل المتسوّق، ويصل الطلب إليك.

المحادثة نفسها والطلب نفسه: #7342 من فرع العليا، بقيمة 94.00 ر.س.

أسواق العليامساعد التسوّق0
أمس
Do you have fresh basil?
نعم، ريحان طازج بـ 4.50 ر.س في فرع العليا.
And parmesan?
بارميجانو 200 غ بـ 18.00 ر.س، متوفر كذلك.
اليوم
أهلًا! اطلب أي شيء من أسواق العليا.
عشاء باستا لـ 4، بولونيز
أكيد. بولونيز لـ 4 من فرع العليا:
اسأل عن أي شيء
الطلب #7342يصل إلى واجهة طلباتك
الأسئلة الشائعة

أسئلة عن الربط.

تستخدم منصة غير مذكورة؟ أخبرنا بها ونحدد طريقة الربط.

راسلنا على hello@bisky.ai

هل تتوفّر وثيقة OpenAPI؟

نعم. يتضمّن توثيق API وثيقة OpenAPI للإصدار v1.

هل يمكن لمنصة إدارة عدة تجّار تجزئة عبر API؟

نعم. لكل متجر مؤسسة مستقلة، ويدير الشركاء المؤسسات التابعة لهم من لوحة تحكّم للشركاء. راجع صفحة «للمنصات».

هل تُنشئ API طلبات في نظامنا؟

تُرسل الطلبات المؤكدة إلى API الطلبات لديك أو تصل كأحداث عبر إشعارات الويب. ولا يُنشأ أي طلب دون تأكيد المتسوّق.

احجز عرضًا

اربط متجرك وشاهده يعمل.

نزامن كتالوجك وفروعك للعرض، ثم نحدد كيف تصلك الطلبات.