اربط متجرك بالأنظمة الأخرى 🔌
نادرًا ما يعمل متجرك وحده؛ فالمنتجات تأتي من مورّد، والمخزون في نظام مستودع، والطلبات تنتقل إلى برنامج محاسبة أو شركة توصيل. تتيح الواجهة البرمجية للمتجر لهذه الأنظمة أن تتواصل مع متجرك مباشرة، فلا يضطر أحد إلى نسخ البيانات يدويًا.
يستطيع المطوّر أو الوكالة أو أداة البرمجة بالذكاء الاصطناعي استخدامها من أجل:
- إضافة المنتجات بالجملة مع خياراتها (اللون والمقاس وغيرهما)، وسعر ومخزون لكل خيار، وصورها
- مزامنة المخزون مع المورّد أو المستودع كل بضع دقائق
- قراءة الطلبات الجديدة فور وصولها وتمريرها إلى نظام آخر
- تحريك الطلبات: مقبول، قيد التوصيل، تم التوصيل، ملغى
- إدارة التصنيفات
أين توجد الواجهة البرمجية؟
لكل متجر واجهته البرمجية الخاصة على عنوانه:
https://your-store.trinavo.com/api/v1، أوhttps://www.your-domain.com/api/v1إذا كنت تستخدم نطاقك الخاص
لا يوجد عنوان مركزي api.trinavo.com، ولا رقم متجر تبحث عنه: عنوان متجرك هو ما يحدّده.
الحصول على صلاحية الوصول
- افتح من لوحة الإدارة إدارة المستخدمين ← رموز الوصول وأنشئ رمزًا جديدًا.
- اختر ما يُسمح له به: قراءة المنتجات والتصنيفات والطلبات أو تعديلها، أو كل شيء.
- انسخ الرمز (يظهر مرة واحدة فقط) وسلّمه للمطوّر أو للأداة. يُرسَل مع كل طلب بالصيغة
Authorization: Bearer <token>.
يمكنك من الشاشة نفسها رؤية كل الرموز وإعادة إنشائها أو إلغاؤها في أي وقت.
توثيق مكتوب للمطوّرين ولأدوات الذكاء الاصطناعي
ينشر كل متجر توثيقه على عنوانه:
- المرجع التفاعلي:
/api/documentation - مواصفات OpenAPI:
/api/openapi.yaml(و/api/openapi.jsonأيضًا)، جاهزة للاستيراد في Postman أو أي أداة لاختبار الواجهات أو في GPT مخصّص - دليل لمساعدات الذكاء الاصطناعي:
/llms-full.txtمع أمثلة عملية، حتى تكتب أدوات مثل ChatGPT وClaude وGemini استدعاءات صحيحة بدل التخمين
يمكنك مشاهدة مثال حي على متجرنا التجريبي: demo.trinavo.com/api/documentation.
ما الذي تغطيه؟
| المجال | ما يمكنك فعله |
|---|---|
| المنتجات | العرض والقراءة والإضافة والتعديل والحذف، والخيارات بالاسم، والصور عبر روابطها، ورمز SKU والباركود والتكلفة والوزن والأبعاد |
| المخزون | تحديد كمية المنتج أو كمية كل خيار، برقمه أو برمز SKU |
| التصنيفات | العرض والقراءة والإضافة والتعديل والتعطيل |
| الطلبات | عرض الطلبات وقراءتها (مع فلتر "تغيّر منذ" للمتابعة الدورية)، وإنشاء الطلبات، وتغيير حالة الطلب |
تعمل التغييرات التي تتم عبر الواجهة البرمجية تمامًا كما في لوحة الإدارة: تُسجَّل حركات المخزون، ويؤدي تغيير حالة الطلب إلى خصم المخزون أو استرداد المبلغ وإشعار العميل كما يفعل زر تغيير الحالة.
معلومات مهمة
- الاستدعاءات تغيّر متجرك الفعلي. لا يوجد متجر تجريبي منفصل، لذا جرّب أي ربط جديد على منتج مخصّص لهذا الغرض.
- التحديثات تُجلب بالاستعلام الدوري. لا تتوفر إشعارات فورية (Webhooks) بعد؛ يطلب الربط كل بضع دقائق الطلبات التي تغيّرت منذ آخر مرة.
- الحدود: 60 طلبًا في الدقيقة لكل رمز.
- احفظ الرموز على الخادم. الرمز الموضوع في صفحة ويب عامة يستطيع أي زائر قراءته.
تريد فقط أن تسأل؟
إذا كان ما تريده إجابات عن مبيعاتك ومخزونك وأرباحك وليس ربطًا برمجيًا، فلا حاجة إلى الواجهة البرمجية أصلًا: اربط شات جي بي تي أو كلود بمتجرك واسأل بكلمات عادية.