احصل على رمز التحديث
من لوحة التحكم، انتقل إلى الإعدادات ← API Integrations واضغط Connect. سيُنشئ ذلك رمزrefresh_token الخاص بك.
هذا الرمز دائم، وهو بيان الاعتماد الوحيد طويل الأمد لديك. ولا يمكن استخدامه لاستدعاء أي شيء سوى نقطة نهاية الرموز.
استبدله برمز وصول
POST /rest/v2/refreshToken Free+
access_token صالح لمدة ساعة واحدة. أرسِله مع كل استدعاء آخر:
تحقق من الاتصال
GET /rest/v2/healthCheck Free+
يؤكد أن المنصة متاحة وتستجيب. يُستحسن ربطه بنظام المراقبة لديك، حتى تعرف عند حدوث أي عطل من أي جانب وقع.
بيئة التجربة (Sandbox)
بيئة منفصلة لها حسابها ورمزها وشركات شحن تجريبية خاصة بها، على العنوانhttps://staging-api.tryoto.com. المسارات نفسها، وهياكل البيانات نفسها.
ابنِ على بيئة التجربة، لكن اختبر الانتقال إلى الإنتاجبيئة التجربة هي المكان الذي تُنشئ فيه طلبات لا تتحول إلى طرود حقيقية، وحجوزات لا تتحول إلى فواتير حقيقية. ولا توجد بيئة أخرى آمنة للتجربة المتكررة.اللحظة التي يجب الاستعداد لها هي الانتقال إلى الإنتاج: ففي بيئة الإنتاج عقود شحن ومراكز ورموز مختلفة. والقيمة الثابتة المكتوبة داخل الكود أثناء التطوير هي المشكلة المعتادة في أول يوم بعد الإطلاق، لذا احفظ كل قيمة خاصة بالبيئة في ملفات الإعداد منذ أول commit.
التوفر حسب الباقة
تخضع نقاط النهاية لمستوى الاشتراك، وبعضها يتطلب أيضًا إضافة (Add-on). وكل نقطة نهاية في الفهرس موضح بجانبها أدنى باقة تتضمنها.الشحن من المتجر عبر واجهة API ميزة في باقة الأعماليمكن إنشاء نقاط استلام الطلب في جميع الباقات، لكن بوصفها مستودعات فقط. أما إنشاء نقطة من النوع
type: "branch"، أي متجر يشحن أيضًا، فمتاح في باقة الأعمال فقط.إذا كنت تخطط لجعل المتاجر تجهّز الطلبات برمجيًا، فهذا هو الحد الذي يجب التحقق منه قبل أن تبني تصميمك عليه. راجع إدارة المراكز لمعرفة ما هو الفرع ولماذا يهم.صفحات ذات صلة
- Webhooks — أن تُبلَّغ بدلًا من أن تسأل.
- فهرس نقاط النهاية — الواجهة كاملةً.