> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryoto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# مجموعة Postman لواجهة OTO API

> استدعِ OTO API من Postman على بيئة التجربة قبل أن تكتب أي شيفرة، مع تجربة أولى في عشر دقائق من رمز الوصول إلى أول طلب.

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

## المجموعة

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

| ما الذي تحصل عليه؟ | لماذا يهم؟ |
| - | - |
| **مخططات الطلبات والاستجابات** | كل حقل، ونوعه، وهل هو مطلوب. |
| **أمثلة تطبيقية** | بيانات مرسلة (Payload) حقيقية بدلًا من قوائم حقول، بما في ذلك الحالات المعقدة مثل شحنة متعددة الصناديق. |
| **كود بلغتك البرمجية** | cURL وJavaScript وPython وPHP وJava وGo وC# وRuby وSwift وغيرها، مولّد من الطلب. |
| **مساعد ذكاء اصطناعي** | مدمج في البوابة، لتسأله عن نقطة النهاية المناسبة بدلًا من قراءتها كلها. |

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

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

> [!TIP]
>
> **عرّف عنوان 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) يمكنك طباعتها.

هذا التسلسل هو عملية الربط كاملةً في صورة مصغرة. وكل ما عدا ذلك مجرد تنويع عليه.

> [!NOTE]
>
> **استخدم عنوانًا حقيقيًا في بيئة التجربة**
>
> يجري التحقق من تغطية شركات الشحن حتى في بيئة التجربة، لذا فإن المدينة المختلقة تُعيد «no carriers available»، فيبدو الأمر كأنه عطل في الربط لا مجرد بيانات اختبار غير صالحة.
>
> اختر مدينة تظهر في `availableCities` واستمر في استخدامها.

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

* [التوثيق](https://docs.tryoto.com/ar/developers/authentication.md) — الحصول على الرمز الذي يعتمد عليه كل ذلك.
* [مرجع REST API](https://docs.tryoto.com/ar/developers/rest-api-reference.md) — ما الذي يوجد أيضًا.
* [apis.tryoto.com](https://apis.tryoto.com) — المجموعة نفسها.


## Related topics

- [نظرة عامة على OTO API](https://docs.tryoto.com/ar/developers/overview.md)
- [مرجع REST API](https://docs.tryoto.com/ar/developers/rest-api-reference.md)
- [مسرد مصطلحات OTO](https://docs.tryoto.com/ar/get-started/glossary.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.