PushizoDocs
API referansı

feature-flags

feature-flags — 6 işlem (GET /v1/apps/{appId}/feature-flags, POST /v1/apps/{appId}/feature-flags, POST /v1/apps/{appId}/feature-flags/evaluate, …). OpenAPI 3.1.0 sözleşmesinden üretilir.

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

İşlemler

YöntemYolİşlem
GET/v1/apps/{appId}/feature-flagsÖzellik bayrakları
POST/v1/apps/{appId}/feature-flagsBayrak oluştur
POST/v1/apps/{appId}/feature-flags/evaluateBayrakları bir kullanıcı için değerlendir
GET/v1/apps/{appId}/feature-flags/{flagId}Bayrak ayrıntısı
PATCH/v1/apps/{appId}/feature-flags/{flagId}Bayrağı güncelle
DELETE/v1/apps/{appId}/feature-flags/{flagId}Bayrağı sil

Ayrıntılar

Özellik bayrakları

GET/v1/apps/{appId}/feature-flagsDene (etkileşimli API belgesi, yeni sekme)

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

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

Yanıtlar

200 — Başarılı.

Şema: AppFlagList

AlanTürZorunluAçıklama
dataarray<object>Evet
data[].idstringEvet
data[].app_idstringEvet
data[].keystringEvet
data[].namestringEvet
data[].descriptionstring | nullEvet
data[].enabledbooleanEvet
data[].value_typeenumEvetDeğerler: "boolean", "string", "number", "json"
data[].on_valueboolean | number | string | array<any> | map<string, any>Evet
data[].off_valueboolean | number | string | array<any> | map<string, any>Evet
data[].rollout_percentintegerEvet
data[].segment_idstring | nullEvet
data[].rollout_schedulearray<object>Evet
data[].rollout_schedule[].atstringEvet
data[].rollout_schedule[].percentintegerEvet
data[].created_atstringEvet
data[].updated_atstringEvet

Örnek yanıt:

{
  "data": [
    {
      "name": "Sipariş bildirimleri",
      "enabled": true,
      "id": "id_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "key": "key-2026-10",
      "description": "Sipariş durumu güncellemeleri",
      "value_type": "boolean",
      "on_value": true,
      "off_value": true,
      "rollout_percent": 1,
      "segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "rollout_schedule": [
        {
          "at": "örnek",
          "percent": 1
        }
      ],
      "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/feature-flags" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"
Sekmesi olmayan dillerde bu işlem için SDK metodu yoktur; cURL örneğini kullanın.

Bayrak oluştur

POST/v1/apps/{appId}/feature-flagsDene (etkileşimli API belgesi, yeni sekme)

Değerler uygulama kimliğini bilen herkesçe okunabilir; gizli bilgi yazmayın.

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

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

İstek gövdesi (zorunlu)

Şema: CreateAppFlagDto

AlanTürZorunluAçıklama
keystringEvet
namestringEvetUzunluk: 1–100
descriptionstring | nullHayır
enabledbooleanHayır
value_typeenumHayırDeğerler: "boolean", "string", "number", "json"
on_valueboolean | number | string | array<any> | map<string, any>Hayır
off_valueboolean | number | string | array<any> | map<string, any>Hayır
rollout_percentintegerHayırAralık: 0–100
segment_idstring | nullHayır
rollout_schedulearray<object>HayırÖğe: 0–10
rollout_schedule[].atstring (date-time)Evet
rollout_schedule[].percentintegerEvetAralık: 0–100

Örnek:

{
  "name": "Sipariş bildirimleri",
  "key": "key-2026-10",
  "enabled": true,
  "description": "Sipariş durumu güncellemeleri",
  "value_type": "boolean",
  "on_value": true,
  "off_value": true
}

Yanıtlar

201 — Başarılı.

Şema: AppFlag

AlanTürZorunluAçıklama
idstringEvet
app_idstringEvet
keystringEvet
namestringEvet
descriptionstring | nullEvet
enabledbooleanEvet
value_typeenumEvetDeğerler: "boolean", "string", "number", "json"
on_valueboolean | number | string | array<any> | map<string, any>Evet
off_valueboolean | number | string | array<any> | map<string, any>Evet
rollout_percentintegerEvet
segment_idstring | nullEvet
rollout_schedulearray<object>Evet
rollout_schedule[].atstringEvet
rollout_schedule[].percentintegerEvet
created_atstringEvet
updated_atstringEvet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "enabled": true,
  "id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "key": "key-2026-10",
  "description": "Sipariş durumu güncellemeleri",
  "value_type": "boolean",
  "on_value": true,
  "off_value": true,
  "rollout_percent": 1,
  "segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "rollout_schedule": [
    {
      "at": "örnek",
      "percent": 1
    }
  ],
  "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 POST "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/feature-flags" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sipariş bildirimleri",
  "key": "key-2026-10",
  "enabled": true,
  "description": "Sipariş durumu güncellemeleri",
  "value_type": "boolean",
  "on_value": true,
  "off_value": true
}'
Sekmesi olmayan dillerde bu işlem için SDK metodu yoktur; cURL örneğini kullanın.

Bayrakları bir kullanıcı için değerlendir

POST/v1/apps/{appId}/feature-flags/evaluateDene (etkileşimli API belgesi, yeni sekme)

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

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

İstek gövdesi (zorunlu)

Şema: EvaluateAppFlagsDto

AlanTürZorunluAçıklama
external_idstringHayırUzunluk: 1–255
user_idstringHayırUzunluk: 1–64
subjectstringHayırUzunluk: 1–128

Örnek:

{
  "external_id": "user_42",
  "user_id": "usr_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "subject": "Siparişiniz yola çıktı"
}

Yanıtlar

200 — Başarılı.

Şema: AppFlagEvaluation

AlanTürZorunluAçıklama
flagsmap<string, object>Evet

Örnek yanıt:

{
  "flags": {
    "key": {
      "enabled": true,
      "value": true,
      "reason": "on"
    }
  }
}

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/feature-flags/evaluate" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "external_id": "user_42",
  "user_id": "usr_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "subject": "Siparişiniz yola çıktı"
}'
Sekmesi olmayan dillerde bu işlem için SDK metodu yoktur; cURL örneğini kullanın.

Bayrak ayrıntısı

GET/v1/apps/{appId}/feature-flags/{flagId}Dene (etkileşimli API belgesi, yeni sekme)

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

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
flagIdyolstringEvet"id_01JD3W5Q7X9K2M4N6P8R0T1V3W"
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

Yanıtlar

200 — Başarılı.

Şema: AppFlag

AlanTürZorunluAçıklama
idstringEvet
app_idstringEvet
keystringEvet
namestringEvet
descriptionstring | nullEvet
enabledbooleanEvet
value_typeenumEvetDeğerler: "boolean", "string", "number", "json"
on_valueboolean | number | string | array<any> | map<string, any>Evet
off_valueboolean | number | string | array<any> | map<string, any>Evet
rollout_percentintegerEvet
segment_idstring | nullEvet
rollout_schedulearray<object>Evet
rollout_schedule[].atstringEvet
rollout_schedule[].percentintegerEvet
created_atstringEvet
updated_atstringEvet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "enabled": true,
  "id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "key": "key-2026-10",
  "description": "Sipariş durumu güncellemeleri",
  "value_type": "boolean",
  "on_value": true,
  "off_value": true,
  "rollout_percent": 1,
  "segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "rollout_schedule": [
    {
      "at": "örnek",
      "percent": 1
    }
  ],
  "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/feature-flags/id_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"
Sekmesi olmayan dillerde bu işlem için SDK metodu yoktur; cURL örneğini kullanın.

Bayrağı güncelle

PATCH/v1/apps/{appId}/feature-flags/{flagId}Dene (etkileşimli API belgesi, yeni sekme)

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

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
flagIdyolstringEvet"id_01JD3W5Q7X9K2M4N6P8R0T1V3W"
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

İstek gövdesi (zorunlu)

Şema: UpdateAppFlagDto

AlanTürZorunluAçıklama
namestringHayırUzunluk: 1–100
descriptionstring | nullHayır
enabledbooleanHayır
value_typeenumHayırDeğerler: "boolean", "string", "number", "json"
on_valueboolean | number | string | array<any> | map<string, any>Hayır
off_valueboolean | number | string | array<any> | map<string, any>Hayır
rollout_percentintegerHayırAralık: 0–100
segment_idstring | nullHayır
rollout_schedulearray<object>HayırÖğe: 0–10
rollout_schedule[].atstring (date-time)Evet
rollout_schedule[].percentintegerEvetAralık: 0–100

Örnek:

{
  "name": "Sipariş bildirimleri",
  "enabled": true,
  "description": "Sipariş durumu güncellemeleri",
  "value_type": "boolean",
  "on_value": true
}

Yanıtlar

200 — Başarılı.

Şema: AppFlag

AlanTürZorunluAçıklama
idstringEvet
app_idstringEvet
keystringEvet
namestringEvet
descriptionstring | nullEvet
enabledbooleanEvet
value_typeenumEvetDeğerler: "boolean", "string", "number", "json"
on_valueboolean | number | string | array<any> | map<string, any>Evet
off_valueboolean | number | string | array<any> | map<string, any>Evet
rollout_percentintegerEvet
segment_idstring | nullEvet
rollout_schedulearray<object>Evet
rollout_schedule[].atstringEvet
rollout_schedule[].percentintegerEvet
created_atstringEvet
updated_atstringEvet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "enabled": true,
  "id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "key": "key-2026-10",
  "description": "Sipariş durumu güncellemeleri",
  "value_type": "boolean",
  "on_value": true,
  "off_value": true,
  "rollout_percent": 1,
  "segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "rollout_schedule": [
    {
      "at": "örnek",
      "percent": 1
    }
  ],
  "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 PATCH "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/feature-flags/id_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sipariş bildirimleri",
  "enabled": true,
  "description": "Sipariş durumu güncellemeleri",
  "value_type": "boolean",
  "on_value": true
}'
Sekmesi olmayan dillerde bu işlem için SDK metodu yoktur; cURL örneğini kullanın.

Bayrağı sil

DELETE/v1/apps/{appId}/feature-flags/{flagId}Dene (etkileşimli API belgesi, yeni sekme)

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

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
flagIdyolstringEvet"id_01JD3W5Q7X9K2M4N6P8R0T1V3W"
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

Yanıtlar

200 — Başarılı.

Şema: Ok

AlanTürZorunluAçıklama
oktrueEvet

Ö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/feature-flags/id_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"
Sekmesi olmayan dillerde bu işlem için SDK metodu yoktur; cURL örneğini kullanın.

SDK uçları (istemci)

SDK uçları (istemci) — 45 işlem (GET /sdk/v1/apps/{appId}/config, POST /sdk/v1/apps/{appId}/subscriptions, PATCH /sdk/v1/apps/{appId}/subscriptions/{subscriptionId}, …). OpenAPI 3.1.0 sözleşmesinden üretilir.

wallet

wallet — 12 işlem (GET /v1/apps/{appId}/wallet/config, PUT /v1/apps/{appId}/wallet/config, GET /v1/apps/{appId}/wallet/templates, …). OpenAPI 3.1.0 sözleşmesinden üretilir.

Bu sayfada

İşlemlerAyrıntılarÖzellik bayrakları200 — Başarılı.Bayrak oluştur201 — Başarılı.Bayrakları bir kullanıcı için değerlendir200 — Başarılı.Bayrak ayrıntısı200 — Başarılı.Bayrağı güncelle200 — Başarılı.Bayrağı sil200 — Başarılı.