بدء مهمة فاتورة غير متزامنة

يبدأ عرض فاتورة PDF الطويلة في الخلفية ويعيد 202 Accepted فوراً مع معرّف المهمة (jobId) ورابط المتابعة (statusUrl). تابع GET /api/orders/{id}/invoice/jobs/{jobId} حتى تصبح الحالة succeeded ثم نزّل الفاتورة.

post/api/v1/orders/{id}/invoice/jobs

Request

  • Base URL: https://shop.alshhbaa.com
  • URL: https://shop.alshhbaa.com/api/v1/orders/{id}/invoice/jobs
  • Auth: none required

Path parameters

idinteger required

Query parameters

tokenstring required

رمز وصول الطلب

Response

قُبلت المهمة للمعالجة. تابع رابط المتابعة حتى الاكتمال.

jobIdstring uuid required

المعرّف الفريد للمهمة غير المتزامنة (job identifier).

orderIdinteger required
status'queued' | 'processing' | 'succeeded' | 'failed' required

الحالة الحالية للمهمة. القيم النهائية succeeded وfailed.

statusUrlstring uri required

رابط المتابعة (polling URL) لقراءة حالة المهمة حتى اكتمالها.

invoiceUrlstring uri

رابط تنزيل الفاتورة بعد اكتمال المهمة.

downloadUrlstring uri

رابط تنزيل PDF المباشر من مورد المهمة عند النجاح.

retryAfterinteger

عدد الثواني المقترح قبل إعادة الاستعلام.

createdAtstring date-time
updatedAtstring date-time
errorstring

Changes

No recorded changes to this operation across all 1 revision of this API.