# دورة الحياة

تنقل نقاط نهاية دورة الحياة رحلة بين الحالات. مرر [Journey ID](/ar/developer/api-reference/api-identifiers/#journey-id) الخاص بالرحلة كـ `uuid` في جسم الطلب. تُرجع الاستدعاء [كائن Journey](/ar/developer/api-reference/customer-journey-api/journey-object/) المحدث.

تكون الرحلة دائمًا في إحدى هذه الحالات:

| الحالة | المعنى |
|---|---|
| `STATUS_DRAFT` | قيد التحرير. لا تعالج المستخدمين. |
| `STATUS_RUNNING` | نشطة، تعالج المستخدمين. |
| `STATUS_PAUSED` | متوقفة مؤقتًا، يمكن استئنافها. |
| `STATUS_FINISHED` | مكتملة، لم تعد تعالج المستخدمين. |
| `STATUS_ARCHIVED` | تمت أرشفتها للتخزين. |

## نقاط النهاية

تستخدم جميع استدعاءات دورة الحياة نفس جسم الطلب: [Journey ID](/ar/developer/api-reference/api-identifiers/#journey-id) الذي يتم تمريره كـ `uuid`. تختلف فقط في المسار:

| الإجراء | الطريقة والمسار | الحالة الناتجة |
|---|---|---|
| بدء | `POST /api/v3/journeygateway/start` | `STATUS_RUNNING` |
| إيقاف مؤقت | `POST /api/v3/journeygateway/pause` | `STATUS_PAUSED` |
| إنهاء | `POST /api/v3/journeygateway/finish` | `STATUS_FINISHED` |
| مسودة | `POST /api/v3/journeygateway/draft` | `STATUS_DRAFT` |
| أرشفة | `POST /api/v3/journeygateway/archive` | `STATUS_ARCHIVED` |

## الطلب

| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
| `uuid` | نعم | string | [Journey ID](/ar/developer/api-reference/api-identifiers/#journey-id) للرحلة التي سيتم نقلها. |

```json title="الجسم"
{ "uuid": "11111111-2222-3333-4444-555555555555" }
```

يتحقق API من الحالة الحالية قبل الانتقال. على سبيل المثال، بدء رحلة تم إنهاؤها بالفعل، أو إيقاف رحلة غير قيد التشغيل مؤقتًا، يُرجع خطأ.

<Aside type="note">
لبدء رحلة **و** تطبيق التعديلات المعلقة في استدعاء واحد، استخدم [التحديث والاستئناف](/ar/developer/api-reference/customer-journey-api/create-update/#update-and-resume) بدلاً من `start`.
</Aside>

### أمثلة على الطلبات

#### بدء رحلة

```bash
curl -X POST https://journey.pushwoosh.com/api/v3/journeygateway/start \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "uuid": "11111111-2222-3333-4444-555555555555" }'
```

#### إيقاف رحلة مؤقتًا

```bash
curl -X POST https://journey.pushwoosh.com/api/v3/journeygateway/pause \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "uuid": "11111111-2222-3333-4444-555555555555" }'
```

## الاستجابة

تُرجع [كائن Journey](/ar/developer/api-reference/customer-journey-api/journey-object/) المحدث: `info`، `points`، و `comments`. يعكس حقل `info.status` الحالة الجديدة.

### مثال على الاستجابة
```json
{
  "info": {
    "uuid": "11111111-2222-3333-4444-555555555555",
    "title": "Welcome series",
    "status": "STATUS_RUNNING",
    "created_at": "2026-05-01T09:00:00Z",
    "updated_at": "2026-06-17T12:00:00Z",
    "params": { "application_code": "XXXXX-XXXXX" },
    "campaign_type": "TriggerBased"
  },
  "points": [],
  "comments": []
}
```

راجع [مرجع كائن Journey](/ar/developer/api-reference/customer-journey-api/journey-object/) للحصول على قائمة الحقول الكاملة.

## مواضيع ذات صلة

<CardGrid>
  <LinkCard title="الإنشاء والتحديث" href="/developer/api-reference/customer-journey-api/create-update/" />
  <LinkCard title="البدء عبر API" href="/developer/api-reference/customer-journey-api/start-by-api/" />
  <LinkCard title="كائن Journey" href="/developer/api-reference/customer-journey-api/journey-object/" />
</CardGrid>