خطافات الويب
تفاعَل مع أحداث دورة الحياة بدلًا من الاستقصاء عنها.
لماذا خطافات الويب بدلًا من الاستقصاء
خطافات الويب هي الوسيلة الأساسية لمتابعة دورة حياة العقد. نقاط الاستقصاء موجودة كبديل، لكن حلقة الاستقصاء تُخبرك متأخرًا وتُكلّف الطرفين طلبات لا حاجة لها.
أحداث دورة الحياة
يمرّ العقد بعدد محدود من الحالات، ويُسلَّم كل انتقال يهمّ المُكامِل على شكل حدث.
| الحالة | الحدث المُسلَّم | معناه |
|---|---|---|
| draft | contract.created | العقد موجود وقيد الإعداد. |
| sent | contract.sent | أُرسل إلى المشاركين فيه. |
| signing | signer.completed, contract.signing_in_progress | انتهى موقّع واحد على الأقل والمسار مستمر. |
| completed | contract.completed | اكتملت كل التواقيع المطلوبة؛ ويُتوقَّع توفّر الملف الموقّع. |
| declined | signer.declined, contract.declined | رفض أحد الموقّعين. |
جلب المستند الموقّع
بعد استلام contract.completed، اجلب الملف الموقّع. قبل الاكتمال تُعيد نقطة «الموقّع فقط» الرمز 404 بحكم التصميم — إذ لا يوجد بعد ملف موقّع لإعادته.
cURL
curl https://api.elcontract.com/api/v1/contracts/$CONTRACT_ID/documents/signed-latest \
-H "Authorization: Bearer $ACCESS_TOKEN"