مناطق الواجهة الموصوفة حاليًا
هذه هي مجالات القدرات، وليست قائمة نقاط نهاية متاحة بشكل غير مشروط. تتبع الأسماء والحقول والحالات والبيئات الوثائق المعتمدة المقدمة بعد مراجعة الوصول.
البحث عن أسعار الشحن
قم بإرسال متطلبات المنشأ والوجهة والحمولة والوزن والأبعاد والخدمة لتلقي الخيارات المنظمة التي يوفرها نظام الأعمال حاليًا. يجب ألا يخترع المتصل أو يعيد كتابة إجمالي الرسوم. ويخضع التوفر للتكامل المعتمد.
تتبع الشحنة المعتمد
استرداد التتبع فقط للطلبات أو الشحنات المصرح للمتصل بالوصول إليها، باستخدام رموز حالة العمل مع معلومات المصدر وآخر تحديث. ويخضع التوفر للتكامل المعتمد.
التطبيقات وتنسيق الدعم
يمكن تقييم الإرسال الخاضع للرقابة وتنسيق الحالة لطلبات مزودي الخدمات والشراكات الترويجية والوصول إلى API، وكذلك لتذاكر الدعم.
استدعاءات أداة الذكاء الاصطناعي المعتمدة
يجوز لمساعد الذكاء الاصطناعي الاتصال فقط بالواجهات المدرجة في القائمة المسموح بها مع عمليات التحقق من التفويض وضوابط التدقيق. لا يمكن لمخرجات النموذج أن تحل محل نتائج واجهة برمجة التطبيقات (API) أو المراجعة البشرية. ويخضع التوفر للتكامل المعتمد.
معلومات المستخدمين والتطبيق المناسبين
مناسب لحالات استخدام المؤسسات التي تتضمن استعلامات مجمعة أو تكامل سير العمل الداخلي أو تنسيق البيانات المعتمدة. يجب أن تتضمن الطلبات تفاصيل الشركة والاتصال، وحالة الاستخدام، والممرات الرئيسية، وأنواع البضائع، ونمط الاتصال المقصود، والقدرة المطلوبة، والاتصال الفني والمتطلبات الأمنية. يجب على مقدم الطلب توفير حجم المكالمات وتكرارها من احتياجات العمل الفعلية.
من التطبيق إلى الإنتاج
يشتمل الإعداد عادةً على تأكيد المتطلبات ومراجعة الكيان والوصول والتقييم الفني والاختبار والتحقق من الصحة وفحوصات الأمان وتأكيد الاتفاقية والموافقة على الإنتاج. لا يمنح التطبيق تلقائيًا الوصول إلى نقطة النهاية أو وضع الحماية أو الإنتاج.
عقد API وقواعد البيانات
يجب أن تحدد الوثائق المعتمدة الإصدارات والمصادقة والحقول والوحدات والعملة والمنطقة الزمنية واللغة ومعرّفات الطلبات وخاصية عدم التكرار (idempotency) وحدود معدل الطلبات والمهلات الزمنية ورموز الأخطاء وسياسة التغيير. ويجب أن تحتفظ الرسوم بالعملة ومدة الصلاحية والتفاصيل التي تعيدها واجهة API؛ وتُوسم القيم غير المعروفة بأنها بحاجة إلى تأكيد، ولا تُعرض على أنها صفر أو مجانية.
بيانات الاعتماد والترخيص وأمن البيانات
يجب أن تبقى مفاتيح API ورموز الوصول في بيئة خادم خاضعة للرقابة، وألا تظهر في كود المتصفح أو تطبيق الهاتف أو المستودعات العامة أو السجلات المرئية. ويجب أن تتحقق كل مكالمة من هوية مقدم الطلب وصلاحيته، وأن تطبق مبدأ أقل الصلاحيات وحدود معدل الطلبات وضوابط التدقيق وإخفاء البيانات عند الحاجة.
كيفية وصف القدرات المخططة
يمكن وصف إنشاء الطلب والتسميات والفوترة والتسوية وخطافات الويب على أنها متاحة فقط بعد اكتمال نقاط النهاية والأذونات وحماية التوقيع أو إعادة التشغيل ومعالجة الأخطاء والاختبار والوثائق المعتمدة. حتى ذلك الحين لا توجد التزامات توفر.