Journey’ler

Journey’ler — 19 işlem (GET /v1/apps/{appId}/journeys, POST /v1/apps/{appId}/journeys, GET /v1/apps/{appId}/journeys/{journeyId}, …). OpenAPI 3.1.0 sözleşmesinden üretilir.

Journey tanımı, sürümleme, yayınlama/duraklatma, run’lar, kullanıcıya göre run listesi ve istatistikler. Graf biçimi için “Journeys” bölümüne bakın.

Taban adres: https://api.pushizo.com · Etiket: journeys · Etkileşimli belge (Scalar)

İşlemler

Yöntem	Yol	İşlem
`GET`	`/v1/apps/{appId}/journeys`	Journey listesi
`POST`	`/v1/apps/{appId}/journeys`	Journey oluştur (taslak)
`GET`	`/v1/apps/{appId}/journeys/{journeyId}`	Journey detayı
`PATCH`	`/v1/apps/{appId}/journeys/{journeyId}`	Ad / açıklama
`DELETE`	`/v1/apps/{appId}/journeys/{journeyId}`	Hiç yayınlanmamış journey'i sil
`PUT`	`/v1/apps/{appId}/journeys/{journeyId}/draft`	Taslağı kaydet
`PATCH`	`/v1/apps/{appId}/journeys/{journeyId}/nodes/{nodeId}`	Taslaktaki düğümü güncelle
`GET`	`/v1/apps/{appId}/journeys/{journeyId}/versions`	Sürümler
`POST`	`/v1/apps/{appId}/journeys/{journeyId}/publish`	Yayınla
`POST`	`/v1/apps/{appId}/journeys/{journeyId}/pause`	Duraklat
`POST`	`/v1/apps/{appId}/journeys/{journeyId}/resume`	Devam ettir
`POST`	`/v1/apps/{appId}/journeys/{journeyId}/archive`	Arşivle
`POST`	`/v1/apps/{appId}/journeys/{journeyId}/duplicate`	Kopyala
`GET`	`/v1/apps/{appId}/journeys/{journeyId}/stats`	Düğüm bazlı istatistik
`GET`	`/v1/apps/{appId}/journeys/{journeyId}/runs`	Run listesi
`POST`	`/v1/apps/{appId}/journeys/{journeyId}/runs`	Kullanıcıyı journey'e sok (external_id, user_id veya alias; context Liquid custom_data)
`GET`	`/v1/apps/{appId}/journeys/{journeyId}/runs/{runId}`	Run detayı ve adımlar
`DELETE`	`/v1/apps/{appId}/journeys/{journeyId}/runs/{runId}`	Run'ı sonlandır
`GET`	`/v1/apps/{appId}/users/by/{label}/{value}/journeys`	Kullanıcının journey run'ları

Ayrıntılar

Journey listesi

GET/v1/apps/{appId}/journeysDene

Kimlik doğrulama: API anahtarı — kapsam analytics:read (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`limit`	sorgu	`integer`	Hayır	Varsayılan: `50`; Aralık: 1–200	`50`
`cursor`	sorgu	`string`	Hayır	Uzunluk: 1–∞	`"eyJpZCI6Im1zZ18wMUpE…"`
`status`	sorgu	`enum`	Hayır	Değerler: `"draft"`, `"active"`, `"paused"`, `"archived"`	`"draft"`
`q`	sorgu	`string`	Hayır	Uzunluk: 0–100	`"ayse"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: JourneyPage

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].app_id`	`string`	Evet
`data[].name`	`string`	Evet
`data[].description`	`string \| null`	Evet
`data[].status`	`enum`	Evet	Değerler: `"draft"`, `"active"`, `"paused"`, `"archived"`
`data[].current_version`	`integer \| null`	Evet
`data[].draft_version`	`integer \| null`	Evet
`data[].trigger_kind`	`string \| null`	Evet
`data[].published_at`	`string \| null`	Evet
`data[].created_by`	`string \| null`	Evet
`data[].created_at`	`string`	Evet
`data[].updated_at`	`string`	Evet
`data[].summary`	`object`	Evet
`data[].summary.runs_total`	`integer`	Evet
`data[].summary.active`	`integer`	Evet
`data[].summary.completed`	`integer`	Evet
`data[].summary.exited`	`integer`	Evet
`data[].summary.failed`	`integer`	Evet
`data[].summary.goal_reached`	`integer`	Evet
`next_cursor`	`string \| null`	Evet
`has_more`	`boolean`	Evet

Örnek yanıt:

{
  "data": [
    {
      "name": "Sipariş bildirimleri",
      "status": "draft",
      "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "description": "Sipariş durumu güncellemeleri",
      "current_version": 1,
      "draft_version": 1,
      "trigger_kind": "örnek",
      "published_at": "örnek",
      "created_by": "örnek",
      "created_at": "örnek",
      "updated_at": "örnek",
      "summary": {
        "runs_total": 1,
        "active": 1,
        "completed": 1,
        "exited": 1,
        "failed": 1,
        "goal_reached": 1
      }
    }
  ],
  "next_cursor": "eyJpZCI6Im1zZ18wMUpE…",
  "has_more": true
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X GET "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys?limit=50" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Journey oluştur (taslak)

POST/v1/apps/{appId}/journeysDene

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

İstek gövdesi (zorunlu)

Alan	Tür	Zorunlu	Açıklama
`name`	`string`	Evet	Uzunluk: 2–120
`description`	`string`	Hayır	Uzunluk: 0–500
`graph`	`object`	Hayır	React Flow uyumlu journey grafı: { nodes: [{ id, type, position, data }], edges: [{ id, source, target, sourceHandle }] } (docs/journeys.md)
`graph.nodes`	`array<object>`	Evet
`graph.edges`	`array<object>`	Evet
`settings`	`object`	Hayır	Yeniden giriş, yalnızca yeni girenler, çıkış kuralları, çıkış tag'leri, hedefler, takvim (docs/journeys.md)

Örnek:

{
  "name": "Sipariş bildirimleri",
  "description": "Sipariş durumu güncellemeleri",
  "graph": {
    "nodes": [
      {}
    ],
    "edges": [
      {}
    ]
  },
  "settings": {}
}

Yanıtlar

201 — Başarılı.

Şema: JourneyDetail

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`name`	`string`	Evet
`description`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"draft"`, `"active"`, `"paused"`, `"archived"`
`current_version`	`integer \| null`	Evet
`draft_version`	`integer \| null`	Evet
`trigger_kind`	`string \| null`	Evet
`published_at`	`string \| null`	Evet
`created_by`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet
`summary`	`object`	Evet
`summary.runs_total`	`integer`	Evet
`summary.active`	`integer`	Evet
`summary.completed`	`integer`	Evet
`summary.exited`	`integer`	Evet
`summary.failed`	`integer`	Evet
`summary.goal_reached`	`integer`	Evet
`editing`	`object`	Evet
`editing.version`	`integer`	Evet
`editing.graph`	`map<string, any>`	Evet
`editing.settings`	`map<string, any>`	Evet
`editing.published_at`	`string \| null`	Evet
`editing.published_by`	`string \| null`	Evet
`editing.created_at`	`string`	Evet
`editing.updated_at`	`string`	Evet
`issues`	`array<object>`	Evet
`issues[].code`	`string`	Evet
`issues[].node_id`	`string`	Hayır
`issues[].edge_id`	`string`	Hayır
`issues[].message`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "description": "Sipariş durumu güncellemeleri",
  "current_version": 1,
  "draft_version": 1,
  "trigger_kind": "örnek",
  "published_at": "örnek",
  "created_by": "örnek",
  "created_at": "örnek",
  "updated_at": "örnek",
  "summary": {
    "runs_total": 1,
    "active": 1,
    "completed": 1,
    "exited": 1,
    "failed": 1,
    "goal_reached": 1
  },
  "editing": {
    "version": 1,
    "graph": {
      "key": "örnek"
    },
    "settings": {},
    "published_at": "örnek",
    "published_by": "örnek",
    "created_at": "örnek",
    "updated_at": "örnek"
  },
  "issues": [
    {
      "code": "örnek",
      "message": "Takip bağlantısı içeride",
      "node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "edge_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X POST "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sipariş bildirimleri",
  "description": "Sipariş durumu güncellemeleri",
  "graph": {
    "nodes": [
      {}
    ],
    "edges": [
      {}
    ]
  },
  "settings": {}
}'

Journey detayı

GET/v1/apps/{appId}/journeys/{journeyId}Dene

Kimlik doğrulama: API anahtarı — kapsam analytics:read (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`journeyId`	yol	`string`	Evet		`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: JourneyDetail

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`name`	`string`	Evet
`description`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"draft"`, `"active"`, `"paused"`, `"archived"`
`current_version`	`integer \| null`	Evet
`draft_version`	`integer \| null`	Evet
`trigger_kind`	`string \| null`	Evet
`published_at`	`string \| null`	Evet
`created_by`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet
`summary`	`object`	Evet
`summary.runs_total`	`integer`	Evet
`summary.active`	`integer`	Evet
`summary.completed`	`integer`	Evet
`summary.exited`	`integer`	Evet
`summary.failed`	`integer`	Evet
`summary.goal_reached`	`integer`	Evet
`editing`	`object`	Evet
`editing.version`	`integer`	Evet
`editing.graph`	`map<string, any>`	Evet
`editing.settings`	`map<string, any>`	Evet
`editing.published_at`	`string \| null`	Evet
`editing.published_by`	`string \| null`	Evet
`editing.created_at`	`string`	Evet
`editing.updated_at`	`string`	Evet
`issues`	`array<object>`	Evet
`issues[].code`	`string`	Evet
`issues[].node_id`	`string`	Hayır
`issues[].edge_id`	`string`	Hayır
`issues[].message`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "description": "Sipariş durumu güncellemeleri",
  "current_version": 1,
  "draft_version": 1,
  "trigger_kind": "örnek",
  "published_at": "örnek",
  "created_by": "örnek",
  "created_at": "örnek",
  "updated_at": "örnek",
  "summary": {
    "runs_total": 1,
    "active": 1,
    "completed": 1,
    "exited": 1,
    "failed": 1,
    "goal_reached": 1
  },
  "editing": {
    "version": 1,
    "graph": {
      "key": "örnek"
    },
    "settings": {},
    "published_at": "örnek",
    "published_by": "örnek",
    "created_at": "örnek",
    "updated_at": "örnek"
  },
  "issues": [
    {
      "code": "örnek",
      "message": "Takip bağlantısı içeride",
      "node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "edge_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X GET "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Ad / açıklama

PATCH/v1/apps/{appId}/journeys/{journeyId}Dene

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`journeyId`	yol	`string`	Evet		`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

İstek gövdesi (zorunlu)

Şema: UpdateJourneyDto

Alan	Tür	Zorunlu	Açıklama
`name`	`string`	Hayır	Uzunluk: 2–120
`description`	`string \| null`	Hayır

Örnek:

{
  "name": "Sipariş bildirimleri",
  "description": "Sipariş durumu güncellemeleri"
}

Yanıtlar

200 — Başarılı.

Şema: JourneyDetail

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`name`	`string`	Evet
`description`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"draft"`, `"active"`, `"paused"`, `"archived"`
`current_version`	`integer \| null`	Evet
`draft_version`	`integer \| null`	Evet
`trigger_kind`	`string \| null`	Evet
`published_at`	`string \| null`	Evet
`created_by`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet
`summary`	`object`	Evet
`summary.runs_total`	`integer`	Evet
`summary.active`	`integer`	Evet
`summary.completed`	`integer`	Evet
`summary.exited`	`integer`	Evet
`summary.failed`	`integer`	Evet
`summary.goal_reached`	`integer`	Evet
`editing`	`object`	Evet
`editing.version`	`integer`	Evet
`editing.graph`	`map<string, any>`	Evet
`editing.settings`	`map<string, any>`	Evet
`editing.published_at`	`string \| null`	Evet
`editing.published_by`	`string \| null`	Evet
`editing.created_at`	`string`	Evet
`editing.updated_at`	`string`	Evet
`issues`	`array<object>`	Evet
`issues[].code`	`string`	Evet
`issues[].node_id`	`string`	Hayır
`issues[].edge_id`	`string`	Hayır
`issues[].message`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "description": "Sipariş durumu güncellemeleri",
  "current_version": 1,
  "draft_version": 1,
  "trigger_kind": "örnek",
  "published_at": "örnek",
  "created_by": "örnek",
  "created_at": "örnek",
  "updated_at": "örnek",
  "summary": {
    "runs_total": 1,
    "active": 1,
    "completed": 1,
    "exited": 1,
    "failed": 1,
    "goal_reached": 1
  },
  "editing": {
    "version": 1,
    "graph": {
      "key": "örnek"
    },
    "settings": {},
    "published_at": "örnek",
    "published_by": "örnek",
    "created_at": "örnek",
    "updated_at": "örnek"
  },
  "issues": [
    {
      "code": "örnek",
      "message": "Takip bağlantısı içeride",
      "node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "edge_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X PATCH "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sipariş bildirimleri",
  "description": "Sipariş durumu güncellemeleri"
}'

Hiç yayınlanmamış journey'i sil

DELETE/v1/apps/{appId}/journeys/{journeyId}Dene

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`journeyId`	yol	`string`	Evet		`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: Ok

Alan	Tür	Zorunlu	Açıklama
`ok`	`true`	Evet

Örnek yanıt:

{
  "ok": true
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X DELETE "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Taslağı kaydet

PUT/v1/apps/{appId}/journeys/{journeyId}/draftDene

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`journeyId`	yol	`string`	Evet		`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

İstek gövdesi (zorunlu)

Alan	Tür	Zorunlu	Açıklama
`graph`	`object`	Evet	React Flow uyumlu journey grafı: { nodes: [{ id, type, position, data }], edges: [{ id, source, target, sourceHandle }] } (docs/journeys.md)
`graph.nodes`	`array<object>`	Evet
`graph.edges`	`array<object>`	Evet
`settings`	`object`	Hayır	Yeniden giriş, yalnızca yeni girenler, çıkış kuralları, çıkış tag'leri, hedefler, takvim (docs/journeys.md)

Örnek:

{
  "graph": {
    "nodes": [
      {}
    ],
    "edges": [
      {}
    ]
  },
  "settings": {}
}

Yanıtlar

200 — Başarılı.

Şema: JourneyDetail

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`name`	`string`	Evet
`description`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"draft"`, `"active"`, `"paused"`, `"archived"`
`current_version`	`integer \| null`	Evet
`draft_version`	`integer \| null`	Evet
`trigger_kind`	`string \| null`	Evet
`published_at`	`string \| null`	Evet
`created_by`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet
`summary`	`object`	Evet
`summary.runs_total`	`integer`	Evet
`summary.active`	`integer`	Evet
`summary.completed`	`integer`	Evet
`summary.exited`	`integer`	Evet
`summary.failed`	`integer`	Evet
`summary.goal_reached`	`integer`	Evet
`editing`	`object`	Evet
`editing.version`	`integer`	Evet
`editing.graph`	`map<string, any>`	Evet
`editing.settings`	`map<string, any>`	Evet
`editing.published_at`	`string \| null`	Evet
`editing.published_by`	`string \| null`	Evet
`editing.created_at`	`string`	Evet
`editing.updated_at`	`string`	Evet
`issues`	`array<object>`	Evet
`issues[].code`	`string`	Evet
`issues[].node_id`	`string`	Hayır
`issues[].edge_id`	`string`	Hayır
`issues[].message`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "description": "Sipariş durumu güncellemeleri",
  "current_version": 1,
  "draft_version": 1,
  "trigger_kind": "örnek",
  "published_at": "örnek",
  "created_by": "örnek",
  "created_at": "örnek",
  "updated_at": "örnek",
  "summary": {
    "runs_total": 1,
    "active": 1,
    "completed": 1,
    "exited": 1,
    "failed": 1,
    "goal_reached": 1
  },
  "editing": {
    "version": 1,
    "graph": {
      "key": "örnek"
    },
    "settings": {},
    "published_at": "örnek",
    "published_by": "örnek",
    "created_at": "örnek",
    "updated_at": "örnek"
  },
  "issues": [
    {
      "code": "örnek",
      "message": "Takip bağlantısı içeride",
      "node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "edge_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X PUT "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W/draft" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "graph": {
    "nodes": [
      {}
    ],
    "edges": [
      {}
    ]
  },
  "settings": {}
}'

Taslaktaki düğümü güncelle

PATCH/v1/apps/{appId}/journeys/{journeyId}/nodes/{nodeId}Dene

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Örnek
`journeyId`	yol	`string`	Evet	`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`nodeId`	yol	`string`	Evet	`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet	`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

İstek gövdesi (zorunlu)

Şema: UpdateNodeDto

Alan	Tür	Zorunlu
`data`	`map<string, any>`	Hayır
`position`	`object`	Hayır
`position.x`	`number`	Evet
`position.y`	`number`	Evet

Örnek:

{
  "data": {
    "order_id": "1001"
  },
  "position": {
    "x": 1.5,
    "y": 1.5
  }
}

Yanıtlar

200 — Başarılı.

Şema: JourneyDetail

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`name`	`string`	Evet
`description`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"draft"`, `"active"`, `"paused"`, `"archived"`
`current_version`	`integer \| null`	Evet
`draft_version`	`integer \| null`	Evet
`trigger_kind`	`string \| null`	Evet
`published_at`	`string \| null`	Evet
`created_by`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet
`summary`	`object`	Evet
`summary.runs_total`	`integer`	Evet
`summary.active`	`integer`	Evet
`summary.completed`	`integer`	Evet
`summary.exited`	`integer`	Evet
`summary.failed`	`integer`	Evet
`summary.goal_reached`	`integer`	Evet
`editing`	`object`	Evet
`editing.version`	`integer`	Evet
`editing.graph`	`map<string, any>`	Evet
`editing.settings`	`map<string, any>`	Evet
`editing.published_at`	`string \| null`	Evet
`editing.published_by`	`string \| null`	Evet
`editing.created_at`	`string`	Evet
`editing.updated_at`	`string`	Evet
`issues`	`array<object>`	Evet
`issues[].code`	`string`	Evet
`issues[].node_id`	`string`	Hayır
`issues[].edge_id`	`string`	Hayır
`issues[].message`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "description": "Sipariş durumu güncellemeleri",
  "current_version": 1,
  "draft_version": 1,
  "trigger_kind": "örnek",
  "published_at": "örnek",
  "created_by": "örnek",
  "created_at": "örnek",
  "updated_at": "örnek",
  "summary": {
    "runs_total": 1,
    "active": 1,
    "completed": 1,
    "exited": 1,
    "failed": 1,
    "goal_reached": 1
  },
  "editing": {
    "version": 1,
    "graph": {
      "key": "örnek"
    },
    "settings": {},
    "published_at": "örnek",
    "published_by": "örnek",
    "created_at": "örnek",
    "updated_at": "örnek"
  },
  "issues": [
    {
      "code": "örnek",
      "message": "Takip bağlantısı içeride",
      "node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "edge_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X PATCH "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W/nodes/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "data": {
    "order_id": "1001"
  },
  "position": {
    "x": 1.5,
    "y": 1.5
  }
}'

Sürümler

GET/v1/apps/{appId}/journeys/{journeyId}/versionsDene

Kimlik doğrulama: API anahtarı — kapsam analytics:read (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`journeyId`	yol	`string`	Evet		`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: JourneyVersionList

Alan	Tür	Zorunlu
`data`	`array<object>`	Evet
`data[].version`	`integer`	Evet
`data[].graph`	`map<string, any>`	Evet
`data[].settings`	`map<string, any>`	Evet
`data[].published_at`	`string \| null`	Evet
`data[].published_by`	`string \| null`	Evet
`data[].created_at`	`string`	Evet
`data[].updated_at`	`string`	Evet

Örnek yanıt:

{
  "data": [
    {
      "version": 1,
      "graph": {
        "key": "örnek"
      },
      "settings": {},
      "published_at": "örnek",
      "published_by": "örnek",
      "created_at": "örnek",
      "updated_at": "örnek"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X GET "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W/versions" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Yayınla

POST/v1/apps/{appId}/journeys/{journeyId}/publishDene

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`journeyId`	yol	`string`	Evet		`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: JourneyPublishResult

Alan	Tür	Zorunlu	Açıklama
`journey`	`object`	Evet
`journey.id`	`string`	Evet
`journey.app_id`	`string`	Evet
`journey.name`	`string`	Evet
`journey.description`	`string \| null`	Evet
`journey.status`	`enum`	Evet	Değerler: `"draft"`, `"active"`, `"paused"`, `"archived"`
`journey.current_version`	`integer \| null`	Evet
`journey.draft_version`	`integer \| null`	Evet
`journey.trigger_kind`	`string \| null`	Evet
`journey.published_at`	`string \| null`	Evet
`journey.created_by`	`string \| null`	Evet
`journey.created_at`	`string`	Evet
`journey.updated_at`	`string`	Evet
`journey.summary`	`object`	Evet
`journey.summary.runs_total`	`integer`	Evet
`journey.summary.active`	`integer`	Evet
`journey.summary.completed`	`integer`	Evet
`journey.summary.exited`	`integer`	Evet
`journey.summary.failed`	`integer`	Evet
`journey.summary.goal_reached`	`integer`	Evet
`version`	`integer`	Evet
`issues`	`array<object>`	Evet
`issues[].code`	`string`	Evet
`issues[].node_id`	`string`	Hayır
`issues[].edge_id`	`string`	Hayır
`issues[].message`	`string`	Evet

Örnek yanıt:

{
  "journey": {
    "name": "Sipariş bildirimleri",
    "status": "draft",
    "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
    "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
    "description": "Sipariş durumu güncellemeleri",
    "current_version": 1,
    "draft_version": 1,
    "trigger_kind": "örnek",
    "published_at": "örnek",
    "created_by": "örnek",
    "created_at": "örnek",
    "updated_at": "örnek",
    "summary": {
      "runs_total": 1,
      "active": 1,
      "completed": 1,
      "exited": 1,
      "failed": 1,
      "goal_reached": 1
    }
  },
  "version": 1,
  "issues": [
    {
      "code": "örnek",
      "message": "Takip bağlantısı içeride",
      "node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "edge_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X POST "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W/publish" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Duraklat

POST/v1/apps/{appId}/journeys/{journeyId}/pauseDene

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`journeyId`	yol	`string`	Evet		`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: JourneyDetail

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`name`	`string`	Evet
`description`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"draft"`, `"active"`, `"paused"`, `"archived"`
`current_version`	`integer \| null`	Evet
`draft_version`	`integer \| null`	Evet
`trigger_kind`	`string \| null`	Evet
`published_at`	`string \| null`	Evet
`created_by`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet
`summary`	`object`	Evet
`summary.runs_total`	`integer`	Evet
`summary.active`	`integer`	Evet
`summary.completed`	`integer`	Evet
`summary.exited`	`integer`	Evet
`summary.failed`	`integer`	Evet
`summary.goal_reached`	`integer`	Evet
`editing`	`object`	Evet
`editing.version`	`integer`	Evet
`editing.graph`	`map<string, any>`	Evet
`editing.settings`	`map<string, any>`	Evet
`editing.published_at`	`string \| null`	Evet
`editing.published_by`	`string \| null`	Evet
`editing.created_at`	`string`	Evet
`editing.updated_at`	`string`	Evet
`issues`	`array<object>`	Evet
`issues[].code`	`string`	Evet
`issues[].node_id`	`string`	Hayır
`issues[].edge_id`	`string`	Hayır
`issues[].message`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "description": "Sipariş durumu güncellemeleri",
  "current_version": 1,
  "draft_version": 1,
  "trigger_kind": "örnek",
  "published_at": "örnek",
  "created_by": "örnek",
  "created_at": "örnek",
  "updated_at": "örnek",
  "summary": {
    "runs_total": 1,
    "active": 1,
    "completed": 1,
    "exited": 1,
    "failed": 1,
    "goal_reached": 1
  },
  "editing": {
    "version": 1,
    "graph": {
      "key": "örnek"
    },
    "settings": {},
    "published_at": "örnek",
    "published_by": "örnek",
    "created_at": "örnek",
    "updated_at": "örnek"
  },
  "issues": [
    {
      "code": "örnek",
      "message": "Takip bağlantısı içeride",
      "node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "edge_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X POST "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W/pause" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Devam ettir

POST/v1/apps/{appId}/journeys/{journeyId}/resumeDene

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`journeyId`	yol	`string`	Evet		`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: JourneyDetail

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`name`	`string`	Evet
`description`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"draft"`, `"active"`, `"paused"`, `"archived"`
`current_version`	`integer \| null`	Evet
`draft_version`	`integer \| null`	Evet
`trigger_kind`	`string \| null`	Evet
`published_at`	`string \| null`	Evet
`created_by`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet
`summary`	`object`	Evet
`summary.runs_total`	`integer`	Evet
`summary.active`	`integer`	Evet
`summary.completed`	`integer`	Evet
`summary.exited`	`integer`	Evet
`summary.failed`	`integer`	Evet
`summary.goal_reached`	`integer`	Evet
`editing`	`object`	Evet
`editing.version`	`integer`	Evet
`editing.graph`	`map<string, any>`	Evet
`editing.settings`	`map<string, any>`	Evet
`editing.published_at`	`string \| null`	Evet
`editing.published_by`	`string \| null`	Evet
`editing.created_at`	`string`	Evet
`editing.updated_at`	`string`	Evet
`issues`	`array<object>`	Evet
`issues[].code`	`string`	Evet
`issues[].node_id`	`string`	Hayır
`issues[].edge_id`	`string`	Hayır
`issues[].message`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "description": "Sipariş durumu güncellemeleri",
  "current_version": 1,
  "draft_version": 1,
  "trigger_kind": "örnek",
  "published_at": "örnek",
  "created_by": "örnek",
  "created_at": "örnek",
  "updated_at": "örnek",
  "summary": {
    "runs_total": 1,
    "active": 1,
    "completed": 1,
    "exited": 1,
    "failed": 1,
    "goal_reached": 1
  },
  "editing": {
    "version": 1,
    "graph": {
      "key": "örnek"
    },
    "settings": {},
    "published_at": "örnek",
    "published_by": "örnek",
    "created_at": "örnek",
    "updated_at": "örnek"
  },
  "issues": [
    {
      "code": "örnek",
      "message": "Takip bağlantısı içeride",
      "node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "edge_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X POST "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W/resume" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Arşivle

POST/v1/apps/{appId}/journeys/{journeyId}/archiveDene

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`journeyId`	yol	`string`	Evet		`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: JourneyDetail

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`name`	`string`	Evet
`description`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"draft"`, `"active"`, `"paused"`, `"archived"`
`current_version`	`integer \| null`	Evet
`draft_version`	`integer \| null`	Evet
`trigger_kind`	`string \| null`	Evet
`published_at`	`string \| null`	Evet
`created_by`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet
`summary`	`object`	Evet
`summary.runs_total`	`integer`	Evet
`summary.active`	`integer`	Evet
`summary.completed`	`integer`	Evet
`summary.exited`	`integer`	Evet
`summary.failed`	`integer`	Evet
`summary.goal_reached`	`integer`	Evet
`editing`	`object`	Evet
`editing.version`	`integer`	Evet
`editing.graph`	`map<string, any>`	Evet
`editing.settings`	`map<string, any>`	Evet
`editing.published_at`	`string \| null`	Evet
`editing.published_by`	`string \| null`	Evet
`editing.created_at`	`string`	Evet
`editing.updated_at`	`string`	Evet
`issues`	`array<object>`	Evet
`issues[].code`	`string`	Evet
`issues[].node_id`	`string`	Hayır
`issues[].edge_id`	`string`	Hayır
`issues[].message`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "description": "Sipariş durumu güncellemeleri",
  "current_version": 1,
  "draft_version": 1,
  "trigger_kind": "örnek",
  "published_at": "örnek",
  "created_by": "örnek",
  "created_at": "örnek",
  "updated_at": "örnek",
  "summary": {
    "runs_total": 1,
    "active": 1,
    "completed": 1,
    "exited": 1,
    "failed": 1,
    "goal_reached": 1
  },
  "editing": {
    "version": 1,
    "graph": {
      "key": "örnek"
    },
    "settings": {},
    "published_at": "örnek",
    "published_by": "örnek",
    "created_at": "örnek",
    "updated_at": "örnek"
  },
  "issues": [
    {
      "code": "örnek",
      "message": "Takip bağlantısı içeride",
      "node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "edge_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X POST "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W/archive" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Kopyala

POST/v1/apps/{appId}/journeys/{journeyId}/duplicateDene

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`journeyId`	yol	`string`	Evet		`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

201 — Başarılı.

Şema: JourneyDetail

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`name`	`string`	Evet
`description`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"draft"`, `"active"`, `"paused"`, `"archived"`
`current_version`	`integer \| null`	Evet
`draft_version`	`integer \| null`	Evet
`trigger_kind`	`string \| null`	Evet
`published_at`	`string \| null`	Evet
`created_by`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet
`summary`	`object`	Evet
`summary.runs_total`	`integer`	Evet
`summary.active`	`integer`	Evet
`summary.completed`	`integer`	Evet
`summary.exited`	`integer`	Evet
`summary.failed`	`integer`	Evet
`summary.goal_reached`	`integer`	Evet
`editing`	`object`	Evet
`editing.version`	`integer`	Evet
`editing.graph`	`map<string, any>`	Evet
`editing.settings`	`map<string, any>`	Evet
`editing.published_at`	`string \| null`	Evet
`editing.published_by`	`string \| null`	Evet
`editing.created_at`	`string`	Evet
`editing.updated_at`	`string`	Evet
`issues`	`array<object>`	Evet
`issues[].code`	`string`	Evet
`issues[].node_id`	`string`	Hayır
`issues[].edge_id`	`string`	Hayır
`issues[].message`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "description": "Sipariş durumu güncellemeleri",
  "current_version": 1,
  "draft_version": 1,
  "trigger_kind": "örnek",
  "published_at": "örnek",
  "created_by": "örnek",
  "created_at": "örnek",
  "updated_at": "örnek",
  "summary": {
    "runs_total": 1,
    "active": 1,
    "completed": 1,
    "exited": 1,
    "failed": 1,
    "goal_reached": 1
  },
  "editing": {
    "version": 1,
    "graph": {
      "key": "örnek"
    },
    "settings": {},
    "published_at": "örnek",
    "published_by": "örnek",
    "created_at": "örnek",
    "updated_at": "örnek"
  },
  "issues": [
    {
      "code": "örnek",
      "message": "Takip bağlantısı içeride",
      "node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "edge_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X POST "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W/duplicate" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Düğüm bazlı istatistik

GET/v1/apps/{appId}/journeys/{journeyId}/statsDene

Kimlik doğrulama: API anahtarı — kapsam analytics:read (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`journeyId`	yol	`string`	Evet		`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`version`	sorgu	`integer`	Hayır	Aralık: 1–∞	`1`
`all_versions`	sorgu	`enum`	Hayır	Değerler: `"true"`, `"false"`	`"true"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: JourneyStats

Alan	Tür	Zorunlu
`version`	`integer \| null`	Evet
`summary`	`object`	Evet
`summary.runs_total`	`integer`	Evet
`summary.active`	`integer`	Evet
`summary.completed`	`integer`	Evet
`summary.exited`	`integer`	Evet
`summary.failed`	`integer`	Evet
`summary.goal_reached`	`integer`	Evet
`summary.waiting`	`integer`	Evet
`summary.goal_conversion_rate`	`number`	Evet
`nodes`	`array<object>`	Evet
`nodes[].node_id`	`string`	Evet
`nodes[].node_type`	`string`	Evet
`nodes[].entered`	`integer`	Evet
`nodes[].completed`	`integer`	Evet
`nodes[].waiting_now`	`integer`	Evet
`nodes[].skipped`	`integer`	Evet
`nodes[].failed`	`integer`	Evet
`nodes[].branches`	`map<string, integer>`	Evet
`nodes[].messages`	`map<string, integer>`	Hayır
`nodes[].variants`	`array<object>`	Hayır
`nodes[].variants[].variant_id`	`string`	Evet
`nodes[].variants[].sent`	`integer`	Evet
`nodes[].variants[].opened`	`integer`	Evet
`nodes[].variants[].clicked`	`integer`	Evet
`nodes[].variants[].converted`	`integer`	Evet
`nodes[].variants[].winner`	`boolean`	Evet
`goals`	`array<object>`	Evet
`goals[].goal_id`	`string`	Evet
`goals[].reached`	`integer`	Evet
`exit_reasons`	`map<string, integer>`	Evet

Örnek yanıt:

{
  "version": 1,
  "summary": {
    "runs_total": 1,
    "active": 1,
    "completed": 1,
    "exited": 1,
    "failed": 1,
    "goal_reached": 1,
    "waiting": 1,
    "goal_conversion_rate": 1.5
  },
  "nodes": [
    {
      "node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "node_type": "örnek",
      "entered": 1,
      "completed": 1,
      "waiting_now": 1,
      "skipped": 1,
      "failed": 1,
      "branches": {
        "key": 150
      },
      "messages": {
        "key": 150
      },
      "variants": [
        {
          "variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
          "sent": 1,
          "opened": 1,
          "clicked": 1,
          "converted": 1,
          "winner": true
        }
      ]
    }
  ],
  "goals": [
    {
      "goal_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "reached": 1
    }
  ],
  "exit_reasons": {
    "key": 150
  }
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X GET "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W/stats" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Run listesi

GET/v1/apps/{appId}/journeys/{journeyId}/runsDene

Kimlik doğrulama: API anahtarı — kapsam analytics:read (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`journeyId`	yol	`string`	Evet		`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`limit`	sorgu	`integer`	Hayır	Varsayılan: `50`; Aralık: 1–200	`50`
`cursor`	sorgu	`string`	Hayır	Uzunluk: 1–∞	`"eyJpZCI6Im1zZ18wMUpE…"`
`status`	sorgu	`enum`	Hayır	Değerler: `"active"`, `"waiting"`, `"completed"`, `"exited"`, `"failed"`	`"active"`
`user_id`	sorgu	`string`	Hayır	Uzunluk: 0–64	`"usr_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`version`	sorgu	`integer`	Hayır	Aralık: 1–∞	`1`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: JourneyRunPage

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].journey_id`	`string`	Evet
`data[].version`	`integer`	Evet
`data[].user_id`	`string`	Evet
`data[].external_id`	`string \| null`	Evet
`data[].status`	`enum`	Evet	Değerler: `"active"`, `"waiting"`, `"completed"`, `"exited"`, `"failed"`
`data[].current_node_id`	`string \| null`	Evet
`data[].next_action_at`	`string \| null`	Evet
`data[].entered_at`	`string`	Evet
`data[].completed_at`	`string \| null`	Evet
`data[].exit_reason`	`string \| null`	Evet
`data[].goal_id`	`string \| null`	Evet
`data[].goal_reached_at`	`string \| null`	Evet
`data[].context`	`map<string, any>`	Evet
`next_cursor`	`string \| null`	Evet
`has_more`	`boolean`	Evet

Örnek yanıt:

{
  "data": [
    {
      "status": "active",
      "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "journey_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "version": 1,
      "user_id": "usr_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "external_id": "user_42",
      "current_node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "next_action_at": "örnek",
      "entered_at": "örnek",
      "completed_at": "örnek",
      "exit_reason": "örnek",
      "goal_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "goal_reached_at": "örnek",
      "context": {
        "key": "örnek"
      }
    }
  ],
  "next_cursor": "eyJpZCI6Im1zZ18wMUpE…",
  "has_more": true
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X GET "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W/runs?limit=50" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Kullanıcıyı journey'e sok (external_id, user_id veya alias; context Liquid custom_data)

POST/v1/apps/{appId}/journeys/{journeyId}/runsDene

Kimlik doğrulama: API anahtarı — kapsam notifications:write (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`journeyId`	yol	`string`	Evet		`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

İstek gövdesi (zorunlu)

Şema: TriggerRunDto

Alan	Tür	Zorunlu	Açıklama
`external_id`	`string`	Hayır	Uzunluk: 1–255
`user_id`	`string`	Hayır	Uzunluk: 1–64
`alias`	`object`	Hayır
`alias.label`	`string`	Evet	Uzunluk: 1–50
`alias.value`	`string`	Evet	Uzunluk: 1–255
`context`	`map<string, any>`	Hayır

Örnek:

{
  "external_id": "user_42",
  "user_id": "usr_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "alias": {
    "label": "external_id",
    "value": "user_42"
  },
  "context": {
    "key": "örnek"
  }
}

Yanıtlar

201 — Başarılı.

Şema: JourneyTriggerResult

Alan	Tür	Zorunlu
`entered`	`boolean`	Evet
`run`	`object \| null`	Evet
`reason`	`enum \| null`	Evet

Örnek yanıt:

{
  "entered": true,
  "run": {
    "status": "active",
    "id": "run_01JD3W5Q7X9K2M4N6P8R0T1V3W",
    "journey_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
    "version": 1,
    "user_id": "usr_01JD3W5Q7X9K2M4N6P8R0T1V3W",
    "external_id": "user_42",
    "current_node_id": "run_01JD3W5Q7X9K2M4N6P8R0T1V3W",
    "next_action_at": "örnek",
    "entered_at": "örnek",
    "completed_at": "örnek",
    "exit_reason": "örnek",
    "goal_id": "run_01JD3W5Q7X9K2M4N6P8R0T1V3W",
    "goal_reached_at": "örnek",
    "context": {
      "key": "örnek"
    }
  },
  "reason": "inactive"
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X POST "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W/runs" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "external_id": "user_42",
  "user_id": "usr_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "alias": {
    "label": "external_id",
    "value": "user_42"
  },
  "context": {
    "key": "örnek"
  }
}'

Run detayı ve adımlar

GET/v1/apps/{appId}/journeys/{journeyId}/runs/{runId}Dene

Kimlik doğrulama: API anahtarı — kapsam analytics:read (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Örnek
`journeyId`	yol	`string`	Evet	`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`runId`	yol	`string`	Evet	`"run_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet	`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: JourneyRunDetail

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`journey_id`	`string`	Evet
`version`	`integer`	Evet
`user_id`	`string`	Evet
`external_id`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"active"`, `"waiting"`, `"completed"`, `"exited"`, `"failed"`
`current_node_id`	`string \| null`	Evet
`next_action_at`	`string \| null`	Evet
`entered_at`	`string`	Evet
`completed_at`	`string \| null`	Evet
`exit_reason`	`string \| null`	Evet
`goal_id`	`string \| null`	Evet
`goal_reached_at`	`string \| null`	Evet
`context`	`map<string, any>`	Evet
`journey_name`	`string`	Evet
`steps`	`array<object>`	Evet
`steps[].id`	`string`	Evet
`steps[].node_id`	`string`	Evet
`steps[].node_type`	`string`	Evet
`steps[].status`	`enum`	Evet	Değerler: `"completed"`, `"waiting"`, `"failed"`, `"skipped"`
`steps[].branch`	`string \| null`	Evet
`steps[].result`	`map<string, any>`	Evet
`steps[].started_at`	`string`	Evet
`steps[].finished_at`	`string \| null`	Evet

Örnek yanıt:

{
  "status": "active",
  "id": "run_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "journey_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "version": 1,
  "user_id": "usr_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "external_id": "user_42",
  "current_node_id": "run_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "next_action_at": "örnek",
  "entered_at": "örnek",
  "completed_at": "örnek",
  "exit_reason": "örnek",
  "goal_id": "run_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "goal_reached_at": "örnek",
  "context": {
    "key": "örnek"
  },
  "journey_name": "örnek",
  "steps": [
    {
      "status": "completed",
      "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "node_type": "örnek",
      "branch": "örnek",
      "result": {
        "key": "örnek"
      },
      "started_at": "örnek",
      "finished_at": "örnek"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X GET "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W/runs/run_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Run'ı sonlandır

DELETE/v1/apps/{appId}/journeys/{journeyId}/runs/{runId}Dene

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Örnek
`journeyId`	yol	`string`	Evet	`"jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`runId`	yol	`string`	Evet	`"run_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet	`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: JourneyRunDetail

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`journey_id`	`string`	Evet
`version`	`integer`	Evet
`user_id`	`string`	Evet
`external_id`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"active"`, `"waiting"`, `"completed"`, `"exited"`, `"failed"`
`current_node_id`	`string \| null`	Evet
`next_action_at`	`string \| null`	Evet
`entered_at`	`string`	Evet
`completed_at`	`string \| null`	Evet
`exit_reason`	`string \| null`	Evet
`goal_id`	`string \| null`	Evet
`goal_reached_at`	`string \| null`	Evet
`context`	`map<string, any>`	Evet
`journey_name`	`string`	Evet
`steps`	`array<object>`	Evet
`steps[].id`	`string`	Evet
`steps[].node_id`	`string`	Evet
`steps[].node_type`	`string`	Evet
`steps[].status`	`enum`	Evet	Değerler: `"completed"`, `"waiting"`, `"failed"`, `"skipped"`
`steps[].branch`	`string \| null`	Evet
`steps[].result`	`map<string, any>`	Evet
`steps[].started_at`	`string`	Evet
`steps[].finished_at`	`string \| null`	Evet

Örnek yanıt:

{
  "status": "active",
  "id": "run_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "journey_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "version": 1,
  "user_id": "usr_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "external_id": "user_42",
  "current_node_id": "run_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "next_action_at": "örnek",
  "entered_at": "örnek",
  "completed_at": "örnek",
  "exit_reason": "örnek",
  "goal_id": "run_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "goal_reached_at": "örnek",
  "context": {
    "key": "örnek"
  },
  "journey_name": "örnek",
  "steps": [
    {
      "status": "completed",
      "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "node_type": "örnek",
      "branch": "örnek",
      "result": {
        "key": "örnek"
      },
      "started_at": "örnek",
      "finished_at": "örnek"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X DELETE "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/journeys/jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W/runs/run_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Kullanıcının journey run'ları

GET/v1/apps/{appId}/users/by/{label}/{value}/journeysDene

Kimlik doğrulama: API anahtarı — kapsam users:read (admin her kapsamı içerir).

Parametreler

Ad	Konum	Tür	Zorunlu	Örnek
`label`	yol	`string`	Evet	`"external_id"`
`value`	yol	`string`	Evet	`"user_42"`
`appId`	yol	`string`	Evet	`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: UserJourneyRuns

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].journey_id`	`string`	Evet
`data[].version`	`integer`	Evet
`data[].user_id`	`string`	Evet
`data[].external_id`	`string \| null`	Evet
`data[].status`	`enum`	Evet	Değerler: `"active"`, `"waiting"`, `"completed"`, `"exited"`, `"failed"`
`data[].current_node_id`	`string \| null`	Evet
`data[].next_action_at`	`string \| null`	Evet
`data[].entered_at`	`string`	Evet
`data[].completed_at`	`string \| null`	Evet
`data[].exit_reason`	`string \| null`	Evet
`data[].goal_id`	`string \| null`	Evet
`data[].goal_reached_at`	`string \| null`	Evet
`data[].context`	`map<string, any>`	Evet
`data[].journey_name`	`string`	Evet

Örnek yanıt:

{
  "data": [
    {
      "status": "active",
      "id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "journey_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "version": 1,
      "user_id": "usr_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "external_id": "user_42",
      "current_node_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "next_action_at": "örnek",
      "entered_at": "örnek",
      "completed_at": "örnek",
      "exit_reason": "örnek",
      "goal_id": "jrn_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "goal_reached_at": "örnek",
      "context": {
        "key": "örnek"
      },
      "journey_name": "örnek"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X GET "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/users/by/external_id/user_42/journeys" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Journey’ler

İşlemlerBağlantıyı kopyala

AyrıntılarBağlantıyı kopyala

Journey listesiBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Journey oluştur (taslak)Bağlantıyı kopyala

201 — Başarılı.Bağlantıyı kopyala

Journey detayıBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Ad / açıklamaBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Hiç yayınlanmamış journey'i silBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Taslağı kaydetBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Taslaktaki düğümü güncelleBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

SürümlerBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

YayınlaBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

DuraklatBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Devam ettirBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

ArşivleBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

KopyalaBağlantıyı kopyala

201 — Başarılı.Bağlantıyı kopyala

Düğüm bazlı istatistikBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Run listesiBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Kullanıcıyı journey'e sok (external_id, user_id veya alias; context Liquid custom_data)Bağlantıyı kopyala

201 — Başarılı.Bağlantıyı kopyala

Run detayı ve adımlarBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Run'ı sonlandırBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Kullanıcının journey run'larıBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Bu sayfada

İşlemler

Ayrıntılar

Journey listesi

200 — Başarılı.

Journey oluştur (taslak)

201 — Başarılı.

Journey detayı

200 — Başarılı.

Ad / açıklama

200 — Başarılı.

Hiç yayınlanmamış journey'i sil

200 — Başarılı.

Taslağı kaydet

200 — Başarılı.

Taslaktaki düğümü güncelle

200 — Başarılı.

Sürümler

200 — Başarılı.

Yayınla

200 — Başarılı.

Duraklat

200 — Başarılı.

Devam ettir

200 — Başarılı.

Arşivle

200 — Başarılı.

Kopyala

201 — Başarılı.

Düğüm bazlı istatistik

200 — Başarılı.

Run listesi

200 — Başarılı.

Kullanıcıyı journey'e sok (external_id, user_id veya alias; context Liquid custom_data)

201 — Başarılı.

Run detayı ve adımlar

200 — Başarılı.

Run'ı sonlandır

200 — Başarılı.

Kullanıcının journey run'ları

200 — Başarılı.