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"
}