نظّم التكامل
- غلّف استدعاءات الـ Gateway في خدمة واحدة أو عميل SDK واحد، لكي يبقى تغيير النموذج أو المزوّد في مكان واحد. راجع التكامل مع الـ Gateway.
- ابثّ الردود إلى واجهات المحادثة، ليرى المستخدمون الـ tokens فور وصولها. راجع البث.
- ضع العمل غير العاجل في طابور، مثل عمليات الإنشاء الخلفية والتقييمات، لتخفيف ذروات الحركة. يشغّل Batch API المهام الكبيرة بشكل غير متزامن.
أبقِ المفاتيح سرية
- احفظ مفاتيح API في مدير أسرار (AWS Secrets Manager أو Doppler أو 1Password) بدلًا من ملفات
.envفي بيئة الإنتاج. - استدعِ الـ Gateway من واجهتك الخلفية، وصادِق تطبيقات العملاء الخاصة بك معها، لكي لا يحمل العملاء مفتاح Gateway أبدًا.
- سجّل بادئة المفتاح فقط، مثل
phaseo_v1_sk_<kid>، ولا تسجّل السر أبدًا.
أعِد المحاولة بأمان
- أعِد محاولة ردود
429و5xxمع تراجع أسّي وتذبذب عشوائي. - انتظر
Retry-Afterقبل إعادة محاولة طلب خضع لتحديد المعدل. - تحقّق في سجلات الطلبات من المزوّد الذي خدم كل طلب، لتلاحظ متى تنتقل الحركة إلى مزوّد آخر.
راقب الإشارات الصحيحة
راجع سجلات الطلبات وقابلية الرصد. احتفظ بقوالب المطالبات والمعاملات وطريقة معالجة المخرجات موثّقة حيث يمكن لفريقك مراجعتها؛ تُبقي الإعدادات المسبقة المطالبات المشتركة والقيم الافتراضية في مكان واحد.