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

​
المجموعة

يوجد المرجع الكامل على apis.tryoto.com، وهو يُولَّد من مجموعة Postman نفسها، لذا لا يبتعد عن الواجهة الفعلية: فكل نقطة نهاية تتضمن نص الطلب الحقيقي، ومثالًا حيًّا للاستجابة، وكودًا قابلًا للتشغيل بأكثر من ثلاثين لغة برمجة.

​
العمل على بيئة التجربة

وجّه المجموعة إلى https://staging-api.tryoto.com وستعمل تمامًا كما تعمل بيئة الإنتاج، مع شركات شحن تجريبية بدلًا من الحقيقية. المسارات نفسها، والبيانات نفسها، والاستجابات نفسها، دون طرود أو فواتير حقيقية.
عرّف عنوان URL الأساسي كمتغير من اليوم الأولالفرق الوحيد بين بيئة التجربة وبيئة الإنتاج هو الخادم والرمز. فإذا كان كلاهما متغيرًا في المجموعة منذ البداية، فإن التبديل بين البيئتين لا يتطلب أكثر من اختيار من قائمة منسدلة.أما إذا كُتبا داخل كل طلب، فالتبديل يعني تعديل كل طلب ونسيان أحدها. وغالبًا ما يكون الطلب المنسيّ هو الذي يُنشئ شيئًا.

​
تجربة أولى في عشر دقائق

  1. احصل على حساب في بيئة التجربة، وعلى refresh_token الخاص به من الإعدادات ← API Integrations.
  2. استدعِ POST /rest/v2/refreshToken، واحفظ access_token في متغير.
  3. استدعِ GET /rest/v2/healthCheck للتأكد من صحة الرمز والخادم معًا.
  4. استدعِ POST /rest/v2/createOrder بالنص المثالي، مع تغيير العنوان إلى مكان تغطيه شركات الشحن التجريبية لديك.
  5. استدعِ POST /rest/v2/checkOTODeliveryFee لهذا المسار وانظر إلى النتيجة: الأسعار ومواعيد التوصيل المتوقعة ومواعيد الإغلاق لكل شركة شحن.
  6. استدعِ POST /rest/v2/createShipment. أصبحت لديك الآن بوليصة شحن (AWB) يمكنك طباعتها.
هذا التسلسل هو عملية الربط كاملةً في صورة مصغرة. وكل ما عدا ذلك مجرد تنويع عليه.
استخدم عنوانًا حقيقيًا في بيئة التجربةيجري التحقق من تغطية شركات الشحن حتى في بيئة التجربة، لذا فإن المدينة المختلقة تُعيد «no carriers available»، فيبدو الأمر كأنه عطل في الربط لا مجرد بيانات اختبار غير صالحة.اختر مدينة تظهر في availableCities واستمر في استخدامها.

​
صفحات ذات صلة