معاينة: يفتح Capydra قريبًا. الطلب غير متاح بعد.

Capydra
Plus المساعدة السلة
عرض الأسبوع

API

الكتالوج والطلبات والمفاتيح عبر واجهة برمجية

اجلبوا كتالوجنا إلى نظامكم، وأطلقوا الطلبات، واستلموا المفاتيح. تعرض هذه الصفحة الطريق في ست خطوات. أما الحدود وبيئة الاختبار والقيود فمذكورة في التوثيق.

يفتح قريباًإلى التوثيق

يعمل هذا فور افتتاح المتجر. وحتى ذلك الحين يمكنكم قراءة كل شيء على مهل.

صفحة المطورين

OpenAPI

كل استدعاء موصوف في ملف OpenAPI 3.1. وكل رقم في الصفحات هو الرقم الذي يفرضه الكود.

جاهزة، وتُفتح مع بدء البيع

الواجهة البرمجية مبنية ومختبرة، والتوثيق متاح على الإنترنت. يمكن إنشاء المفاتيح فور افتتاح المتجر. غير متوفر حتى الآن ومخطط له فقط: حزمة برمجية جاهزة، ورصيد مسبق الدفع.

ما الذي يمكنكم فعله بها

  • مزامنة الكتالوج

    حمّلوا القائمة كاملة مرة واحدة، ثم ما تغيّر فقط منذ آخر مزامنة. وهناك عرض خفيف يُظهر المخزون فقط.

    جاهزة، وتُفتح مع بدء البيع
  • إطلاق الطلبات

    طلب واحد لكل استدعاء، مع حد للسعر ورقمكم الخاص ومفتاح يمنع الشراء المزدوج.

    جاهزة، وتُفتح مع بدء البيع
  • استلام المفاتيح

    بصلاحية مستقلة، مع العدّ والتسجيل. وأول استدعاء ينهي حق الانسحاب لهذا الطلب.

    جاهزة، وتُفتح مع بدء البيع
  • استقبال Webhooks

    استدعاءات موقّعة إلى خادمكم عند تغيّر طلب أو منتج. حتى 3 عنوانًا.

    جاهزة، وتُفتح مع بدء البيع
  • العرض بصفة بائع

    إدارة العروض والأسعار والمخزون من نظام المخزون لديكم. وهذا يفترض أن يكون البيع على Capydra مفتوحًا.

    جاهزة، وتُفتح مع بدء البيع
  • الاستخدام مع مساعدي الذكاء الاصطناعي

    الحساب نفسه يعمل عبر خادم MCP لدينا. القواعد والحدود هي نفسها.

    جاهزة، وتُفتح مع بدء البيع

ست خطوات حتى الاستدعاء الأول

  1. 1

    أنشئوا حسابًا

    تسجلون الدخول إلى المتجر.

  2. 2

    أنشئوا مفتاحًا

    ضمن "مفاتيح API": اسم ودور (مشترٍ أو بائع) والصلاحيات التي تحتاجونها. امنحوا أقل عدد ممكن منها.

  3. 3

    أكّدوا إقرار التنازل

    جملتان عن الانسحاب، مرة واحدة. وكل طلب يُنفَّذ بالمفتاح يشير إليهما.

  4. 4

    احموا المفتاح

    يظهر مرة واحدة فقط. احفظوه مثل كلمة مرور وأضيفوا عناوين IP لخوادمكم إلى القائمة.

  5. 5

    حدّدوا حدًا يوميًا

    مجموع كل طلبات اليوم محدود: €250 لمفتاح جديد، ويمكن ضبطه حتى €5,000.

  6. 6

    أرسلوا الاستدعاء الأول

    مع المفتاح في ترويسة "Authorization". يقرأ المثال أدناه أول المنتجات.

الاستدعاء الأول

يبدأ المفتاح بـ omk_live_. ويُرسل في كل استدعاء بوصفه قيمة Bearer. المال مذكور بالسنتات الكاملة ويشمل رسوم الخدمة.

curl "https://capydra.com/api/v1/catalog/products?page=1" \
  -H "Authorization: Bearer omk_live_YOUR_KEY"

# فقط ما تغيّر منذ آخر مزامنة لكم
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
  -H "Authorization: Bearer omk_live_YOUR_KEY"

تابعوا في التوثيق

403

المتجر غير مفتوح بعد: الاستدعاءات التي تغيّر شيئًا تردّ بـ 403 showcase_mode، ولا تحتوي الردود على أسعار.

الأسئلة الشائعة

كم تكلف واجهة API؟

الوصول مجاني. تدفعون ثمن الطلبات التي تطلقونها. لا توجد رسوم أساسية.

هل توجد حزمة برمجية جاهزة؟

ليس بعد. يحتوي التوثيق على أمثلة بـ curl، ويمكن تحميل ملف OpenAPI في الأدوات الشائعة.

كيف أحصل على حدود أعلى؟

اكتبوا لنا مشروعكم وكميتكم. نرفع الحدود للشركاء الذين نرى حاجتهم.

ماذا يحدث إذا سُرق مفتاحي؟

ألغوه في صفحة المفاتيح وأنشئوا مفتاحًا جديدًا. وحتى ذلك الحين يحدّ الحد اليومي وقائمة IP من الضرر. والاستدعاءات المريبة تجمّد المفتاح تلقائيًا.

أين أبلّغ عن خطأ في واجهة API؟

عبر نموذج الاتصال مع اختيار موضوع API. اذكروا الاستدعاء والوقت.

هل أنتم مستعدون للاستدعاء الأول؟

اقرؤوا صفحة المطورين حتى نهايتها، ثم أنشئوا مفتاحًا.

أرسل طلباً