تخطَّ إلى المستندات
API

بدء تصدير

ملف zip لمساحة العمل كاملة، يُصنع في الخلفية.

POST/exports

ينفّذ الاستدعاء الحقيقي على مساحة عملك.

POST /exports

ملف zip لمساحة العمل كاملة، يُصنع في الخلفية.

مثال

يحتاج إلى threads:read. لا يأخذ جسمًا ويجيب بـ 201 مع التصدير، queued. اقرأه حتى تصبح status هي ready، ثم نزّله.

curl
curl -X POST "$OE/exports" -H "$AUTH"
الاستجابة
{  "object": "export",  "id": "exp_8c1e4a7f2b9d3e6a0c5f1b28",  "status": "queued",  "phase": null,  "createdAt": "2026-09-30T09:12:44.000Z",  "createdBy": { "name": "Ana Lima", "email": "[email protected]" },  "startedAt": "2026-09-30T09:12:46.000Z",  "finishedAt": "2026-09-30T09:31:02.000Z",  "expiresAt": "2027-09-30T09:31:02.000Z",  "sizeBytes": 1840233472,  "fileName": "acme_20260930_093102.zip",  "threadsDone": 18420,  "threadsTotal": 18420,  "error": null}

يجري تصدير واحد في كل مرة: وتصدير آخر أثناء صنعه يعطي 409 already_running. ويمكن تصدير مساحة العمل مرة في اليوم، والتصدير داخل ذلك اليوم يعطي 429 export_limit_reached.

يطلب التطبيق رمز تحقق أولًا: وإلى أن يتحقق من رمز، يجيب الطلب بـ 403 step_up_required. ولا يُطلب ذلك أبدًا من مفتاح API.

المرجع