تأسيسيv1عقود المنصة
الأخطاء وCorrelation IDs
اعرض خطأً قابلاً للتعامل دون كشف stack أو SQL أو بيانات مستأجر آخر.
غلاف الخطأ
يجب أن يميز العميل بين code ثابت للآلة وmessage قابلة للترجمة وcorrelation_id للدعم. لا يبني منطقًا على نص الرسالة.
{\n "error": {\n "code": "scope_denied",\n "message": "The requested scope is not available.",\n "correlation_id": "<opaque-id>",\n "retryable": false\n }\n}تصنيف قابل للتصرف
صنّف validation وauthentication وauthorization وconflict وrate limit وtransient dependency وinternal. أضف retryable وretry_after عندما يكون ذلك صحيحًا.
خصوصية الخطأ
يمنع الرد من كشف stack traces أو أسماء جداول أو queries أو paths محلية أو secrets أو وجود مورد خارج نطاق المستأجر.