App’ler

App’ler — 7 işlem (GET /v1/organization, GET /v1/organization/members, GET /v1/organization/audit-logs, …). OpenAPI 3.1.0 sözleşmesinden üretilir.

Organizasyondaki app’ler (bildirim gönderilen ürünler). Listeleme ve oluşturma org geneli admin anahtarı ister; app ayarları ve veri temizliği app anahtarıyla da yapılabilir.

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

İşlemler

Yöntem	Yol	İşlem
`GET`	`/v1/organization`	Anahtarın ait olduğu organizasyon (org geneli admin anahtarı)
`GET`	`/v1/organization/members`	Organizasyon üyeleri (org geneli admin anahtarı)
`GET`	`/v1/organization/audit-logs`	Audit log (org geneli admin anahtarı; action/actor/app/tarih filtreleri, cursor)
`GET`	`/v1/apps`	App listesi (org geneli admin anahtarı)
`POST`	`/v1/apps`	App oluştur (org geneli admin anahtarı)
`GET`	`/v1/apps/{appId}`	App detayı
`PATCH`	`/v1/apps/{appId}`	App ayarlarını güncelle

Ayrıntılar

Anahtarın ait olduğu organizasyon (org geneli admin anahtarı)

GET/v1/organizationDene

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

Yanıtlar

200 — Başarılı.

Şema: Org

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`name`	`string`	Evet
`slug`	`string`	Evet
`plan_code`	`string`	Evet
`status`	`enum`	Evet	Değerler: `"active"`, `"suspended"`, `"deleted"`
`settings`	`object`	Evet
`settings.mfaRequired`	`boolean`	Hayır
`settings.ipAllowlist`	`array<string>`	Hayır	Öğe: 0–50
`settings.retentionDays`	`integer`	Hayır	Aralık: 7–3650
`settings.sessionMaxHours`	`integer`	Hayır	Aralık: 1–2160
`settings.auditStream`	`object`	Hayır
`settings.auditStream.s3`	`boolean`	Hayır
`settings.auditStream.webhookAppId`	`string \| null`	Hayır
`created_at`	`string`	Evet
`region`	`string \| null`	Evet
`managed_by_reseller`	`boolean`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "active",
  "id": "org_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "slug": "magaza",
  "plan_code": "örnek",
  "settings": {
    "mfaRequired": true,
    "ipAllowlist": [
      "örnek"
    ],
    "retentionDays": 7,
    "sessionMaxHours": 1
  },
  "created_at": "örnek",
  "region": "örnek",
  "managed_by_reseller": 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/organization" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Organizasyon üyeleri (org geneli admin anahtarı)

GET/v1/organization/membersDene

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

Yanıtlar

200 — Başarılı.

Şema: MemberList

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].account_id`	`string`	Evet
`data[].email`	`string`	Evet
`data[].name`	`string`	Evet
`data[].role`	`enum`	Evet	Değerler: `"owner"`, `"admin"`, `"developer"`, `"marketer"`, `"analyst"`, `"billing"`, `"viewer"`, `"composer"`
`data[].app_scopes`	`array<string>`	Evet
`data[].accepted_at`	`string \| null`	Evet
`data[].created_at`	`string`	Evet
`data[].last_login_at`	`string \| null`	Evet

Örnek yanıt:

{
  "data": [
    {
      "name": "Sipariş bildirimleri",
      "id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "account_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "email": "ayse@example.com",
      "role": "owner",
      "app_scopes": [
        "örnek"
      ],
      "accepted_at": "örnek",
      "created_at": "örnek",
      "last_login_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/organization/members" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Audit log (org geneli admin anahtarı; action/actor/app/tarih filtreleri, cursor)

GET/v1/organization/audit-logsDene

Kimlik doğrulama: API anahtarı — kapsam admin (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…"`
`action`	sorgu	`string`	Hayır	Uzunluk: 1–100	`"örnek"`
`actor_id`	sorgu	`string`	Hayır	Uzunluk: 1–64	`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`app_id`	sorgu	`string`	Hayır	Uzunluk: 1–64	`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`from`	sorgu	`string (date-time)`	Hayır		`"2026-10-17T09:00:00Z"`
`to`	sorgu	`string (date-time)`	Hayır		`"2026-10-17T09:00:00Z"`

Yanıtlar

200 — Başarılı.

Şema: AuditPage

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].org_id`	`string`	Evet
`data[].app_id`	`string \| null`	Evet
`data[].actor_type`	`enum`	Evet	Değerler: `"account"`, `"api_key"`, `"system"`
`data[].actor_id`	`string \| null`	Evet
`data[].action`	`string`	Evet
`data[].target_type`	`string \| null`	Evet
`data[].target_id`	`string \| null`	Evet
`data[].metadata`	`map<string, any>`	Evet
`data[].ip`	`string \| null`	Evet
`data[].request_id`	`string \| null`	Evet
`data[].created_at`	`string`	Evet
`next_cursor`	`string \| null`	Evet
`has_more`	`boolean`	Evet

Örnek yanıt:

{
  "data": [
    {
      "id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "org_id": "org_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "actor_type": "account",
      "actor_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "action": "örnek",
      "target_type": "örnek",
      "target_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "metadata": {
        "order_id": "1001"
      },
      "ip": "örnek",
      "request_id": "req_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "created_at": "ö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/organization/audit-logs?limit=50" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

App listesi (org geneli admin anahtarı)

GET/v1/appsDene

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

Yanıtlar

200 — Başarılı.

Şema: AppList

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].org_id`	`string`	Evet
`data[].name`	`string`	Evet
`data[].slug`	`string`	Evet
`data[].platform_flags`	`object`	Evet
`data[].platform_flags.ios`	`boolean`	Hayır
`data[].platform_flags.android`	`boolean`	Hayır
`data[].platform_flags.web`	`boolean`	Hayır
`data[].platform_flags.email`	`boolean`	Hayır
`data[].platform_flags.sms`	`boolean`	Hayır
`data[].icon_url`	`string \| null`	Evet
`data[].default_language`	`string`	Evet
`data[].timezone`	`string`	Evet
`data[].settings`	`object`	Evet
`data[].settings.quietHours`	`object \| null`	Hayır
`data[].settings.frequencyCap`	`object \| null`	Hayır
`data[].settings.frequencyCaps`	`array<object>`	Hayır	Öğe: 0–10
`data[].settings.inApp`	`object`	Hayır
`data[].settings.androidChannels`	`array<object>`	Hayır	Öğe: 0–50
`data[].settings.sms`	`object`	Hayır
`data[].settings.preferenceCenter`	`object`	Hayır
`data[].settings.defaultTtlSeconds`	`integer`	Hayır	Aralık: 60–2419200
`data[].settings.identityVerificationRequired`	`boolean`	Hayır
`data[].settings.allowedOrigins`	`array<string>`	Hayır	Öğe: 0–50
`data[].settings.campaignApprovalRequired`	`boolean`	Hayır
`data[].settings.webPush`	`object`	Hayır
`data[].settings.onboarding`	`object`	Hayır
`data[].settings.sdkSetup`	`object \| null`	Hayır
`data[].identity_verification_mode`	`enum`	Evet	Değerler: `"hmac"`, `"jwt"`, `"both"`
`data[].status`	`enum`	Evet	Değerler: `"active"`, `"suspended"`, `"deleted"`
`data[].created_at`	`string`	Evet
`data[].updated_at`	`string`	Evet

Örnek yanıt:

{
  "data": [
    {
      "name": "Sipariş bildirimleri",
      "status": "active",
      "id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "org_id": "org_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "slug": "magaza",
      "platform_flags": {
        "ios": true,
        "android": true
      },
      "icon_url": "https://example.com/orders/1001",
      "default_language": "örnek",
      "timezone": "Europe/Istanbul",
      "settings": {
        "quietHours": {
          "start": "2026-10-01T00:00:00Z",
          "end": "2026-10-17T00:00:00Z",
          "timezoneMode": "user"
        },
        "frequencyCap": {
          "max": 1,
          "windowHours": 1
        }
      },
      "identity_verification_mode": "hmac",
      "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" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

App oluştur (org geneli admin anahtarı)

POST/v1/appsDene

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

İstek gövdesi (zorunlu)

Şema: CreateAppDto

Alan	Tür	Zorunlu	Açıklama
`name`	`string`	Evet	Uzunluk: 2–100
`slug`	`string`	Hayır
`platform_flags`	`object`	Hayır	Varsayılan: `{}`
`platform_flags.ios`	`boolean`	Hayır
`platform_flags.android`	`boolean`	Hayır
`platform_flags.web`	`boolean`	Hayır
`platform_flags.email`	`boolean`	Hayır
`platform_flags.sms`	`boolean`	Hayır
`default_language`	`string`	Hayır	Varsayılan: `"en"`; Uzunluk: 2–10
`timezone`	`string`	Hayır	Varsayılan: `"UTC"`; Uzunluk: 1–64

Örnek:

{
  "name": "Sipariş bildirimleri",
  "slug": "magaza",
  "platform_flags": {},
  "default_language": "en",
  "timezone": "UTC"
}

Yanıtlar

201 — Başarılı.

Şema: App

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`org_id`	`string`	Evet
`name`	`string`	Evet
`slug`	`string`	Evet
`platform_flags`	`object`	Evet
`platform_flags.ios`	`boolean`	Hayır
`platform_flags.android`	`boolean`	Hayır
`platform_flags.web`	`boolean`	Hayır
`platform_flags.email`	`boolean`	Hayır
`platform_flags.sms`	`boolean`	Hayır
`icon_url`	`string \| null`	Evet
`default_language`	`string`	Evet
`timezone`	`string`	Evet
`settings`	`object`	Evet
`settings.quietHours`	`object \| null`	Hayır
`settings.frequencyCap`	`object \| null`	Hayır
`settings.frequencyCaps`	`array<object>`	Hayır	Öğe: 0–10
`settings.frequencyCaps[].max`	`integer`	Evet	Aralık: 1–1000
`settings.frequencyCaps[].window`	`object`	Evet
`settings.frequencyCaps[].channels`	`array<enum>`	Hayır	Öğe: 1–8
`settings.inApp`	`object`	Hayır
`settings.inApp.minIntervalSeconds`	`integer`	Hayır	Aralık: 0–604800
`settings.androidChannels`	`array<object>`	Hayır	Öğe: 0–50
`settings.androidChannels[].id`	`string`	Evet	Uzunluk: 1–64
`settings.androidChannels[].name`	`string`	Evet	Uzunluk: 1–60
`settings.androidChannels[].description`	`string`	Hayır	Uzunluk: 0–200
`settings.androidChannels[].importance`	`enum`	Evet	Değerler: `"low"`, `"default"`, `"high"`, `"urgent"`
`settings.androidChannels[].sound`	`string`	Hayır	Uzunluk: 0–64
`settings.androidChannels[].vibration`	`boolean`	Hayır
`settings.androidChannels[].group`	`string`	Hayır	Uzunluk: 0–64
`settings.sms`	`object`	Hayır
`settings.sms.helpReply`	`string`	Hayır	Uzunluk: 0–320
`settings.sms.stopReply`	`string`	Hayır	Uzunluk: 0–320
`settings.sms.autoReply`	`boolean`	Hayır
`settings.preferenceCenter`	`object`	Hayır
`settings.preferenceCenter.enabled`	`boolean`	Hayır
`settings.preferenceCenter.brandName`	`string`	Hayır	Uzunluk: 0–80
`settings.preferenceCenter.logoUrl`	`string (url)`	Hayır	Uzunluk: 0–2000
`settings.preferenceCenter.accentColor`	`string`	Hayır
`settings.preferenceCenter.customUnsubscribeUrl`	`string (url)`	Hayır	Uzunluk: 0–2000
`settings.preferenceCenter.texts`	`map<string, object>`	Hayır
`settings.defaultTtlSeconds`	`integer`	Hayır	Aralık: 60–2419200
`settings.identityVerificationRequired`	`boolean`	Hayır
`settings.allowedOrigins`	`array<string>`	Hayır	Öğe: 0–50
`settings.campaignApprovalRequired`	`boolean`	Hayır
`settings.webPush`	`object`	Hayır
`settings.webPush.serviceWorkerPath`	`string`	Hayır	Uzunluk: 0–200
`settings.webPush.serviceWorkerScope`	`string`	Hayır	Uzunluk: 0–200
`settings.webPush.prompt`	`object`	Hayır
`settings.webPush.welcomeNotification`	`object`	Hayır
`settings.webPush.clickBehavior`	`object`	Hayır
`settings.webPush.customLink`	`object`	Hayır
`settings.webPush.promptBackoffDays`	`array<integer>`	Hayır	Öğe: 0–10
`settings.onboarding`	`object`	Hayır
`settings.onboarding.step`	`integer`	Evet	Aralık: 0–6
`settings.onboarding.simulation`	`boolean`	Hayır
`settings.onboarding.completed_at`	`string \| null`	Hayır
`settings.onboarding.version`	`integer`	Hayır	Aralık: 1–100
`settings.onboarding.platforms`	`array<enum>`	Hayır	Öğe: 0–4
`settings.onboarding.framework`	`enum`	Hayır	Değerler: `"native"`, `"flutter"`, `"react-native"`, `"unity"`, `"capacitor"`, `"cordova"`, `"maui"`
`settings.onboarding.web_integration`	`enum`	Hayır	Değerler: `"code"`, `"wordpress"`
`settings.sdkSetup`	`object \| null`	Hayır
`identity_verification_mode`	`enum`	Evet	Değerler: `"hmac"`, `"jwt"`, `"both"`
`status`	`enum`	Evet	Değerler: `"active"`, `"suspended"`, `"deleted"`
`created_at`	`string`	Evet
`updated_at`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "active",
  "id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "org_id": "org_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "slug": "magaza",
  "platform_flags": {
    "ios": true,
    "android": true,
    "web": true,
    "email": true
  },
  "icon_url": "https://example.com/orders/1001",
  "default_language": "örnek",
  "timezone": "Europe/Istanbul",
  "settings": {
    "quietHours": {
      "start": "2026-10-01T00:00:00Z",
      "end": "2026-10-17T00:00:00Z",
      "timezoneMode": "user"
    },
    "frequencyCap": {
      "max": 1,
      "windowHours": 1
    },
    "frequencyCaps": [
      {
        "max": 1,
        "window": {
          "value": 150,
          "unit": "minutes"
        },
        "channels": [
          "ios_push"
        ]
      }
    ],
    "inApp": {
      "minIntervalSeconds": 1
    }
  },
  "identity_verification_mode": "hmac",
  "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" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sipariş bildirimleri",
  "slug": "magaza",
  "platform_flags": {},
  "default_language": "en",
  "timezone": "UTC"
}'

App detayı

GET/v1/apps/{appId}Dene

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

Parametreler

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

Yanıtlar

200 — Başarılı.

Şema: App

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`org_id`	`string`	Evet
`name`	`string`	Evet
`slug`	`string`	Evet
`platform_flags`	`object`	Evet
`platform_flags.ios`	`boolean`	Hayır
`platform_flags.android`	`boolean`	Hayır
`platform_flags.web`	`boolean`	Hayır
`platform_flags.email`	`boolean`	Hayır
`platform_flags.sms`	`boolean`	Hayır
`icon_url`	`string \| null`	Evet
`default_language`	`string`	Evet
`timezone`	`string`	Evet
`settings`	`object`	Evet
`settings.quietHours`	`object \| null`	Hayır
`settings.frequencyCap`	`object \| null`	Hayır
`settings.frequencyCaps`	`array<object>`	Hayır	Öğe: 0–10
`settings.frequencyCaps[].max`	`integer`	Evet	Aralık: 1–1000
`settings.frequencyCaps[].window`	`object`	Evet
`settings.frequencyCaps[].channels`	`array<enum>`	Hayır	Öğe: 1–8
`settings.inApp`	`object`	Hayır
`settings.inApp.minIntervalSeconds`	`integer`	Hayır	Aralık: 0–604800
`settings.androidChannels`	`array<object>`	Hayır	Öğe: 0–50
`settings.androidChannels[].id`	`string`	Evet	Uzunluk: 1–64
`settings.androidChannels[].name`	`string`	Evet	Uzunluk: 1–60
`settings.androidChannels[].description`	`string`	Hayır	Uzunluk: 0–200
`settings.androidChannels[].importance`	`enum`	Evet	Değerler: `"low"`, `"default"`, `"high"`, `"urgent"`
`settings.androidChannels[].sound`	`string`	Hayır	Uzunluk: 0–64
`settings.androidChannels[].vibration`	`boolean`	Hayır
`settings.androidChannels[].group`	`string`	Hayır	Uzunluk: 0–64
`settings.sms`	`object`	Hayır
`settings.sms.helpReply`	`string`	Hayır	Uzunluk: 0–320
`settings.sms.stopReply`	`string`	Hayır	Uzunluk: 0–320
`settings.sms.autoReply`	`boolean`	Hayır
`settings.preferenceCenter`	`object`	Hayır
`settings.preferenceCenter.enabled`	`boolean`	Hayır
`settings.preferenceCenter.brandName`	`string`	Hayır	Uzunluk: 0–80
`settings.preferenceCenter.logoUrl`	`string (url)`	Hayır	Uzunluk: 0–2000
`settings.preferenceCenter.accentColor`	`string`	Hayır
`settings.preferenceCenter.customUnsubscribeUrl`	`string (url)`	Hayır	Uzunluk: 0–2000
`settings.preferenceCenter.texts`	`map<string, object>`	Hayır
`settings.defaultTtlSeconds`	`integer`	Hayır	Aralık: 60–2419200
`settings.identityVerificationRequired`	`boolean`	Hayır
`settings.allowedOrigins`	`array<string>`	Hayır	Öğe: 0–50
`settings.campaignApprovalRequired`	`boolean`	Hayır
`settings.webPush`	`object`	Hayır
`settings.webPush.serviceWorkerPath`	`string`	Hayır	Uzunluk: 0–200
`settings.webPush.serviceWorkerScope`	`string`	Hayır	Uzunluk: 0–200
`settings.webPush.prompt`	`object`	Hayır
`settings.webPush.welcomeNotification`	`object`	Hayır
`settings.webPush.clickBehavior`	`object`	Hayır
`settings.webPush.customLink`	`object`	Hayır
`settings.webPush.promptBackoffDays`	`array<integer>`	Hayır	Öğe: 0–10
`settings.onboarding`	`object`	Hayır
`settings.onboarding.step`	`integer`	Evet	Aralık: 0–6
`settings.onboarding.simulation`	`boolean`	Hayır
`settings.onboarding.completed_at`	`string \| null`	Hayır
`settings.onboarding.version`	`integer`	Hayır	Aralık: 1–100
`settings.onboarding.platforms`	`array<enum>`	Hayır	Öğe: 0–4
`settings.onboarding.framework`	`enum`	Hayır	Değerler: `"native"`, `"flutter"`, `"react-native"`, `"unity"`, `"capacitor"`, `"cordova"`, `"maui"`
`settings.onboarding.web_integration`	`enum`	Hayır	Değerler: `"code"`, `"wordpress"`
`settings.sdkSetup`	`object \| null`	Hayır
`identity_verification_mode`	`enum`	Evet	Değerler: `"hmac"`, `"jwt"`, `"both"`
`status`	`enum`	Evet	Değerler: `"active"`, `"suspended"`, `"deleted"`
`created_at`	`string`	Evet
`updated_at`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "active",
  "id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "org_id": "org_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "slug": "magaza",
  "platform_flags": {
    "ios": true,
    "android": true,
    "web": true,
    "email": true
  },
  "icon_url": "https://example.com/orders/1001",
  "default_language": "örnek",
  "timezone": "Europe/Istanbul",
  "settings": {
    "quietHours": {
      "start": "2026-10-01T00:00:00Z",
      "end": "2026-10-17T00:00:00Z",
      "timezoneMode": "user"
    },
    "frequencyCap": {
      "max": 1,
      "windowHours": 1
    },
    "frequencyCaps": [
      {
        "max": 1,
        "window": {
          "value": 150,
          "unit": "minutes"
        },
        "channels": [
          "ios_push"
        ]
      }
    ],
    "inApp": {
      "minIntervalSeconds": 1
    }
  },
  "identity_verification_mode": "hmac",
  "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" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

App ayarlarını güncelle

PATCH/v1/apps/{appId}Dene

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)

Şema: UpdateAppDto

Alan	Tür	Zorunlu	Açıklama
`name`	`string`	Hayır	Uzunluk: 2–100
`platform_flags`	`object`	Hayır
`platform_flags.ios`	`boolean`	Hayır
`platform_flags.android`	`boolean`	Hayır
`platform_flags.web`	`boolean`	Hayır
`platform_flags.email`	`boolean`	Hayır
`platform_flags.sms`	`boolean`	Hayır
`icon_url`	`string (uri) \| null`	Hayır
`default_language`	`string`	Hayır	Uzunluk: 2–10
`timezone`	`string`	Hayır	Uzunluk: 1–64
`settings`	`object`	Hayır
`settings.quietHours`	`object \| null`	Hayır
`settings.frequencyCap`	`object \| null`	Hayır
`settings.frequencyCaps`	`array<object>`	Hayır	Öğe: 0–10
`settings.frequencyCaps[].max`	`integer`	Evet	Aralık: 1–1000
`settings.frequencyCaps[].window`	`object`	Evet
`settings.frequencyCaps[].window.value`	`integer`	Evet	Aralık: 1–366
`settings.frequencyCaps[].window.unit`	`enum`	Evet	Değerler: `"minutes"`, `"hours"`, `"days"`, `"weeks"`
`settings.frequencyCaps[].channels`	`array<enum>`	Hayır	Öğe: 1–8
`settings.inApp`	`object`	Hayır
`settings.inApp.minIntervalSeconds`	`integer`	Hayır	Aralık: 0–604800
`settings.androidChannels`	`array<object>`	Hayır	Öğe: 0–50
`settings.androidChannels[].id`	`string`	Evet	Uzunluk: 1–64
`settings.androidChannels[].name`	`string`	Evet	Uzunluk: 1–60
`settings.androidChannels[].description`	`string`	Hayır	Uzunluk: 0–200
`settings.androidChannels[].importance`	`enum`	Evet	Değerler: `"low"`, `"default"`, `"high"`, `"urgent"`
`settings.androidChannels[].sound`	`string`	Hayır	Uzunluk: 0–64
`settings.androidChannels[].vibration`	`boolean`	Hayır
`settings.androidChannels[].group`	`string`	Hayır	Uzunluk: 0–64
`settings.sms`	`object`	Hayır
`settings.sms.helpReply`	`string`	Hayır	Uzunluk: 0–320
`settings.sms.stopReply`	`string`	Hayır	Uzunluk: 0–320
`settings.sms.autoReply`	`boolean`	Hayır
`settings.preferenceCenter`	`object`	Hayır
`settings.preferenceCenter.enabled`	`boolean`	Hayır
`settings.preferenceCenter.brandName`	`string`	Hayır	Uzunluk: 0–80
`settings.preferenceCenter.logoUrl`	`string (url)`	Hayır	Uzunluk: 0–2000
`settings.preferenceCenter.accentColor`	`string`	Hayır
`settings.preferenceCenter.customUnsubscribeUrl`	`string (url)`	Hayır	Uzunluk: 0–2000
`settings.preferenceCenter.texts`	`map<string, object>`	Hayır
`settings.defaultTtlSeconds`	`integer`	Hayır	Aralık: 60–2419200
`settings.identityVerificationRequired`	`boolean`	Hayır
`settings.allowedOrigins`	`array<string>`	Hayır	Öğe: 0–50
`settings.campaignApprovalRequired`	`boolean`	Hayır
`settings.webPush`	`object`	Hayır
`settings.webPush.serviceWorkerPath`	`string`	Hayır	Uzunluk: 0–200
`settings.webPush.serviceWorkerScope`	`string`	Hayır	Uzunluk: 0–200
`settings.webPush.prompt`	`object`	Hayır
`settings.webPush.prompt.enabled`	`boolean`	Evet
`settings.webPush.prompt.type`	`enum`	Evet	Değerler: `"slidedown"`, `"native"`
`settings.webPush.prompt.collect`	`enum`	Hayır	Değerler: `"push"`, `"email"`, `"sms"`, `"email_sms"`
`settings.webPush.prompt.delaySeconds`	`integer`	Hayır	Aralık: 0–600
`settings.webPush.prompt.pageViews`	`integer`	Hayır	Aralık: 1–50
`settings.webPush.prompt.scrollPercent`	`integer`	Hayır	Aralık: 1–100
`settings.webPush.prompt.texts`	`map<string, object>`	Hayır
`settings.webPush.prompt.categories`	`array<object>`	Hayır	Öğe: 0–10
`settings.webPush.prompt.categories[].tag`	`string`	Evet	Uzunluk: 1–64
`settings.webPush.prompt.categories[].label`	`map<string, string>`	Evet
`settings.webPush.prompt.accentColor`	`string`	Hayır
`settings.webPush.welcomeNotification`	`object`	Hayır
`settings.webPush.welcomeNotification.enabled`	`boolean`	Evet
`settings.webPush.welcomeNotification.url`	`string (url)`	Hayır	Uzunluk: 0–2000
`settings.webPush.welcomeNotification.texts`	`map<string, object>`	Hayır
`settings.webPush.clickBehavior`	`object`	Hayır
`settings.webPush.clickBehavior.match`	`enum`	Evet	Değerler: `"exact"`, `"origin"`
`settings.webPush.clickBehavior.action`	`enum`	Evet	Değerler: `"navigate"`, `"focus"`
`settings.webPush.customLink`	`object`	Hayır
`settings.webPush.customLink.enabled`	`boolean`	Evet
`settings.webPush.customLink.style`	`enum`	Evet	Değerler: `"button"`, `"link"`
`settings.webPush.customLink.size`	`enum`	Evet	Değerler: `"small"`, `"medium"`, `"large"`
`settings.webPush.customLink.color`	`object`	Hayır
`settings.webPush.customLink.color.button`	`string`	Hayır
`settings.webPush.customLink.color.text`	`string`	Hayır
`settings.webPush.customLink.texts`	`map<string, object>`	Hayır
`settings.webPush.customLink.unsubscribeEnabled`	`boolean`	Hayır
`settings.webPush.promptBackoffDays`	`array<integer>`	Hayır	Öğe: 0–10
`settings.onboarding`	`object`	Hayır
`settings.onboarding.step`	`integer`	Evet	Aralık: 0–6
`settings.onboarding.simulation`	`boolean`	Hayır
`settings.onboarding.completed_at`	`string \| null`	Hayır
`settings.onboarding.version`	`integer`	Hayır	Aralık: 1–100
`settings.onboarding.platforms`	`array<enum>`	Hayır	Öğe: 0–4
`settings.onboarding.framework`	`enum`	Hayır	Değerler: `"native"`, `"flutter"`, `"react-native"`, `"unity"`, `"capacitor"`, `"cordova"`, `"maui"`
`settings.onboarding.web_integration`	`enum`	Hayır	Değerler: `"code"`, `"wordpress"`
`settings.sdkSetup`	`object \| null`	Hayır
`identity_verification_mode`	`enum`	Hayır	Değerler: `"hmac"`, `"jwt"`, `"both"`

Örnek:

{
  "name": "Sipariş bildirimleri",
  "platform_flags": {
    "ios": true,
    "android": true,
    "web": true
  },
  "icon_url": "https://example.com/orders/1001",
  "default_language": "örnek",
  "timezone": "Europe/Istanbul"
}

Yanıtlar

200 — Başarılı.

Şema: App

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`org_id`	`string`	Evet
`name`	`string`	Evet
`slug`	`string`	Evet
`platform_flags`	`object`	Evet
`platform_flags.ios`	`boolean`	Hayır
`platform_flags.android`	`boolean`	Hayır
`platform_flags.web`	`boolean`	Hayır
`platform_flags.email`	`boolean`	Hayır
`platform_flags.sms`	`boolean`	Hayır
`icon_url`	`string \| null`	Evet
`default_language`	`string`	Evet
`timezone`	`string`	Evet
`settings`	`object`	Evet
`settings.quietHours`	`object \| null`	Hayır
`settings.frequencyCap`	`object \| null`	Hayır
`settings.frequencyCaps`	`array<object>`	Hayır	Öğe: 0–10
`settings.frequencyCaps[].max`	`integer`	Evet	Aralık: 1–1000
`settings.frequencyCaps[].window`	`object`	Evet
`settings.frequencyCaps[].channels`	`array<enum>`	Hayır	Öğe: 1–8
`settings.inApp`	`object`	Hayır
`settings.inApp.minIntervalSeconds`	`integer`	Hayır	Aralık: 0–604800
`settings.androidChannels`	`array<object>`	Hayır	Öğe: 0–50
`settings.androidChannels[].id`	`string`	Evet	Uzunluk: 1–64
`settings.androidChannels[].name`	`string`	Evet	Uzunluk: 1–60
`settings.androidChannels[].description`	`string`	Hayır	Uzunluk: 0–200
`settings.androidChannels[].importance`	`enum`	Evet	Değerler: `"low"`, `"default"`, `"high"`, `"urgent"`
`settings.androidChannels[].sound`	`string`	Hayır	Uzunluk: 0–64
`settings.androidChannels[].vibration`	`boolean`	Hayır
`settings.androidChannels[].group`	`string`	Hayır	Uzunluk: 0–64
`settings.sms`	`object`	Hayır
`settings.sms.helpReply`	`string`	Hayır	Uzunluk: 0–320
`settings.sms.stopReply`	`string`	Hayır	Uzunluk: 0–320
`settings.sms.autoReply`	`boolean`	Hayır
`settings.preferenceCenter`	`object`	Hayır
`settings.preferenceCenter.enabled`	`boolean`	Hayır
`settings.preferenceCenter.brandName`	`string`	Hayır	Uzunluk: 0–80
`settings.preferenceCenter.logoUrl`	`string (url)`	Hayır	Uzunluk: 0–2000
`settings.preferenceCenter.accentColor`	`string`	Hayır
`settings.preferenceCenter.customUnsubscribeUrl`	`string (url)`	Hayır	Uzunluk: 0–2000
`settings.preferenceCenter.texts`	`map<string, object>`	Hayır
`settings.defaultTtlSeconds`	`integer`	Hayır	Aralık: 60–2419200
`settings.identityVerificationRequired`	`boolean`	Hayır
`settings.allowedOrigins`	`array<string>`	Hayır	Öğe: 0–50
`settings.campaignApprovalRequired`	`boolean`	Hayır
`settings.webPush`	`object`	Hayır
`settings.webPush.serviceWorkerPath`	`string`	Hayır	Uzunluk: 0–200
`settings.webPush.serviceWorkerScope`	`string`	Hayır	Uzunluk: 0–200
`settings.webPush.prompt`	`object`	Hayır
`settings.webPush.welcomeNotification`	`object`	Hayır
`settings.webPush.clickBehavior`	`object`	Hayır
`settings.webPush.customLink`	`object`	Hayır
`settings.webPush.promptBackoffDays`	`array<integer>`	Hayır	Öğe: 0–10
`settings.onboarding`	`object`	Hayır
`settings.onboarding.step`	`integer`	Evet	Aralık: 0–6
`settings.onboarding.simulation`	`boolean`	Hayır
`settings.onboarding.completed_at`	`string \| null`	Hayır
`settings.onboarding.version`	`integer`	Hayır	Aralık: 1–100
`settings.onboarding.platforms`	`array<enum>`	Hayır	Öğe: 0–4
`settings.onboarding.framework`	`enum`	Hayır	Değerler: `"native"`, `"flutter"`, `"react-native"`, `"unity"`, `"capacitor"`, `"cordova"`, `"maui"`
`settings.onboarding.web_integration`	`enum`	Hayır	Değerler: `"code"`, `"wordpress"`
`settings.sdkSetup`	`object \| null`	Hayır
`identity_verification_mode`	`enum`	Evet	Değerler: `"hmac"`, `"jwt"`, `"both"`
`status`	`enum`	Evet	Değerler: `"active"`, `"suspended"`, `"deleted"`
`created_at`	`string`	Evet
`updated_at`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "active",
  "id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "org_id": "org_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "slug": "magaza",
  "platform_flags": {
    "ios": true,
    "android": true,
    "web": true,
    "email": true
  },
  "icon_url": "https://example.com/orders/1001",
  "default_language": "örnek",
  "timezone": "Europe/Istanbul",
  "settings": {
    "quietHours": {
      "start": "2026-10-01T00:00:00Z",
      "end": "2026-10-17T00:00:00Z",
      "timezoneMode": "user"
    },
    "frequencyCap": {
      "max": 1,
      "windowHours": 1
    },
    "frequencyCaps": [
      {
        "max": 1,
        "window": {
          "value": 150,
          "unit": "minutes"
        },
        "channels": [
          "ios_push"
        ]
      }
    ],
    "inApp": {
      "minIntervalSeconds": 1
    }
  },
  "identity_verification_mode": "hmac",
  "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" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sipariş bildirimleri",
  "platform_flags": {
    "ios": true,
    "android": true,
    "web": true
  },
  "icon_url": "https://example.com/orders/1001",
  "default_language": "örnek",
  "timezone": "Europe/Istanbul"
}'

App’ler

İşlemlerBağlantıyı kopyala

AyrıntılarBağlantıyı kopyala

Anahtarın ait olduğu organizasyon (org geneli admin anahtarı)Bağlantıyı kopyala

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

Organizasyon üyeleri (org geneli admin anahtarı)Bağlantıyı kopyala

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

Audit log (org geneli admin anahtarı; action/actor/app/tarih filtreleri, cursor)Bağlantıyı kopyala

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

App listesi (org geneli admin anahtarı)Bağlantıyı kopyala

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

App oluştur (org geneli admin anahtarı)Bağlantıyı kopyala

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

App detayıBağlantıyı kopyala

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

App ayarlarını güncelleBağlantıyı kopyala

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

Bu sayfada

İşlemler

Ayrıntılar

Anahtarın ait olduğu organizasyon (org geneli admin anahtarı)

200 — Başarılı.

Organizasyon üyeleri (org geneli admin anahtarı)

200 — Başarılı.

Audit log (org geneli admin anahtarı; action/actor/app/tarih filtreleri, cursor)

200 — Başarılı.

App listesi (org geneli admin anahtarı)

200 — Başarılı.

App oluştur (org geneli admin anahtarı)

201 — Başarılı.

App detayı

200 — Başarılı.

App ayarlarını güncelle

200 — Başarılı.