Approval Required

approval-required · 202

يجب أن يوافق شخص على هذا النداء قبل تنفيذه، فحجزته الـ API ولم تغير شيئا.

كل الصفحات

الحالة 202 ليست خطأ: قبل النداء وهو ينتظر شخصا يوافق عليه أو يرفضه. والنداء الذي يسمي agent هو وحده الذي يحجز، والقرار يظهر على pollUrl.

إضافة إلى الحقول التي في كل خطأ، يضيف هذا النوع approvalId، pollUrl، expiresAt، operation، projectId و approvalPolicy.

الأسباب الشائعة

  • يحمل النداء header X-Ghaym-Agent أو X-Ghaym-Session أو X-Ghaym-Intent، فيحسب نداء agent. والنداء الذي لا يحمل أيا منها يحسب نداء شخص، ولا يحجز أبدا.
  • سياسة الموافقة في المشروع standard أو strict، والنداء يحذف مشروعا أو بيئة أو خدمة أو domain، أو يطبق تغييرات مجهزة تحذف متغيرا أو خدمة أو نسخة قاعدة. وفي sandbox لا يحجز أي شيء.
  • السياسة strict، والنداء يطلق خدمة كلفتها الشهرية المتوقعة فوق الحد المحدد.
  • طلب agent إرجاع جلسة بـ POST /v1/agent-sessions/<id>/rollback، تحت أي سياسة غير sandbox. وهنا يكون operation هو session.rollback.

كيف تصلح الطلب

  • لا ترسل النداء مرة أخرى: بعد الموافقة عليه، تنفذ الـ API النداء المحجوز بنفسها. والإرسال الثاني بالـ X-Ghaym-Session نفسه يعيد لك الموافقة المنتظرة نفسها، والإرسال دون جلسة يحجز كموافقة ثانية.
  • استعلم من pollUrl حتى يصبح status غير pending: ينتهي إلى approved أو denied أو expired. ومن الـ CLI، شغل ghaym cloud approvals wait <id>، ويخرج الـ CLI بالرمز 6 عندما يحجز نداء.
  • أخبر المستخدم بما ينتظر: operation يسمي النداء، والموافقة تنتهي عند expiresAt.
  • لكي تفحص نداء دون حجز أي شيء، أرسله مع ?dryRun=true أولا. التجربة لا تحجز أبدا.

مثال على الرد

json
{
  "type": "approval-required",
  "title": "Approval Required",
  "detail": "This project's 'standard' approval policy holds project.delete for a human decision. Nothing has been changed. Poll /v1/approvals/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402 until its status is no longer 'pending'; it expires at 2026-07-29T09:30:00.000Z.",
  "status": 202,
  "approvalId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402",
  "pollUrl": "/v1/approvals/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402",
  "expiresAt": "2026-07-29T09:30:00.000Z",
  "operation": "project.delete",
  "projectId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "approvalPolicy": "standard",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "method": "DELETE",
  "instance": "DELETE /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "docs": "https://ghaym.me/docs/errors/approval-required"
}