API
الكتالوج والطلبات والمفاتيح عبر واجهة برمجية
اجلبوا كتالوجنا إلى نظامكم، وأطلقوا الطلبات، واستلموا المفاتيح. تعرض هذه الصفحة الطريق في ست خطوات. أما الحدود وبيئة الاختبار والقيود فمذكورة في التوثيق.
صفحة المطورين
OpenAPI
كل استدعاء موصوف في ملف OpenAPI 3.1. وكل رقم في الصفحات هو الرقم الذي يفرضه الكود.
- Bearerمفتاح واحد لكل تطبيق، يُخزَّن كقيمة Hash فقط، مع انتهاء صلاحية وتدوير
- JSONالمال بالسنتات الكاملة، والتواريخ بصيغة ISO 8601، والأسماء بصيغة snake_case
- 120 في الدقيقةقراءات لمفتاح جديد، و600 حين يبلغ عمره 7 يومًا
- موقّعWebhooks بتوقيع، وعند الطلب استدعاءات موقّعة أيضًا (RFC 9421)
الواجهة البرمجية مبنية ومختبرة، والتوثيق متاح على الإنترنت. يمكن إنشاء المفاتيح فور افتتاح المتجر. غير متوفر حتى الآن ومخطط له فقط: حزمة برمجية جاهزة، ورصيد مسبق الدفع.
ما الذي يمكنكم فعله بها
مزامنة الكتالوج
حمّلوا القائمة كاملة مرة واحدة، ثم ما تغيّر فقط منذ آخر مزامنة. وهناك عرض خفيف يُظهر المخزون فقط.
جاهزة، وتُفتح مع بدء البيعإطلاق الطلبات
طلب واحد لكل استدعاء، مع حد للسعر ورقمكم الخاص ومفتاح يمنع الشراء المزدوج.
جاهزة، وتُفتح مع بدء البيعاستلام المفاتيح
بصلاحية مستقلة، مع العدّ والتسجيل. وأول استدعاء ينهي حق الانسحاب لهذا الطلب.
جاهزة، وتُفتح مع بدء البيعاستقبال Webhooks
استدعاءات موقّعة إلى خادمكم عند تغيّر طلب أو منتج. حتى 3 عنوانًا.
جاهزة، وتُفتح مع بدء البيعالعرض بصفة بائع
إدارة العروض والأسعار والمخزون من نظام المخزون لديكم. وهذا يفترض أن يكون البيع على Capydra مفتوحًا.
جاهزة، وتُفتح مع بدء البيعالاستخدام مع مساعدي الذكاء الاصطناعي
الحساب نفسه يعمل عبر خادم MCP لدينا. القواعد والحدود هي نفسها.
جاهزة، وتُفتح مع بدء البيع
ست خطوات حتى الاستدعاء الأول
- 1
أنشئوا حسابًا
تسجلون الدخول إلى المتجر.
- 2
أنشئوا مفتاحًا
ضمن "مفاتيح API": اسم ودور (مشترٍ أو بائع) والصلاحيات التي تحتاجونها. امنحوا أقل عدد ممكن منها.
- 3
أكّدوا إقرار التنازل
جملتان عن الانسحاب، مرة واحدة. وكل طلب يُنفَّذ بالمفتاح يشير إليهما.
- 4
احموا المفتاح
يظهر مرة واحدة فقط. احفظوه مثل كلمة مرور وأضيفوا عناوين IP لخوادمكم إلى القائمة.
- 5
حدّدوا حدًا يوميًا
مجموع كل طلبات اليوم محدود: €250 لمفتاح جديد، ويمكن ضبطه حتى €5,000.
- 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 showcase_mode، ولا تحتوي الردود على أسعار.
الأسئلة الشائعة
كم تكلف واجهة API؟
الوصول مجاني. تدفعون ثمن الطلبات التي تطلقونها. لا توجد رسوم أساسية.
هل توجد حزمة برمجية جاهزة؟
ليس بعد. يحتوي التوثيق على أمثلة بـ curl، ويمكن تحميل ملف OpenAPI في الأدوات الشائعة.
كيف أحصل على حدود أعلى؟
اكتبوا لنا مشروعكم وكميتكم. نرفع الحدود للشركاء الذين نرى حاجتهم.
ماذا يحدث إذا سُرق مفتاحي؟
ألغوه في صفحة المفاتيح وأنشئوا مفتاحًا جديدًا. وحتى ذلك الحين يحدّ الحد اليومي وقائمة IP من الضرر. والاستدعاءات المريبة تجمّد المفتاح تلقائيًا.
أين أبلّغ عن خطأ في واجهة API؟
عبر نموذج الاتصال مع اختيار موضوع API. اذكروا الاستدعاء والوقت.
هل أنتم مستعدون للاستدعاء الأول؟
اقرؤوا صفحة المطورين حتى نهايتها، ثم أنشئوا مفتاحًا.
أرسل طلباً