Entegrasyonlar
Entegrasyonlar — 4 işlem (GET /v1/apps/{appId}/integrations/zapier/me, POST /v1/apps/{appId}/integrations/zapier/hooks, DELETE /v1/apps/{appId}/integrations/zapier/hooks/{hookId}, …). OpenAPI 3.1.0 sözleşmesinden üretilir.
Hazır entegrasyonlar: Zapier tetikleyici abonelikleri ve analitik hedefleri (Segment, Amplitude, Mixpanel).
Taban adres: https://api.pushizo.com · Etiket: integrations · Etkileşimli belge (Scalar)
İşlemler
| Yöntem | Yol | İşlem |
|---|---|---|
GET | /v1/apps/{appId}/integrations/zapier/me | Zapier bağlantı testi: anahtarın app’i ve kapsamları |
POST | /v1/apps/{appId}/integrations/zapier/hooks | REST Hook aboneliği (Zap açıldı) |
DELETE | /v1/apps/{appId}/integrations/zapier/hooks/{hookId} | REST Hook aboneliğini sil (Zap kapatıldı) |
GET | /v1/apps/{appId}/integrations/zapier/samples | Tetik örnekleri (performList): son kayıtlar, abonelik gövdesiyle aynı biçim |
Ayrıntılar
Zapier bağlantı testi: anahtarın app’i ve kapsamları
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: ZapierMe
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
app_id | string | Evet | |
app_name | string | Evet | |
org_id | string | Evet | |
scopes | array<string> | Evet |
Örnek yanıt:
{
"app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"app_name": "örnek",
"org_id": "org_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"scopes": [
"notifications:write"
]
}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/integrations/zapier/me" \
-H "Authorization: Bearer $PUSHIZO_API_KEY"REST Hook aboneliği (Zap açıldı)
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" |
İstek gövdesi (zorunlu)
Şema: ZapierSubscribeDto
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
target_url | string | Evet | Uzunluk: 1–2000 |
event | enum | Evet | Değerler: "subscription.created", "subscription.unsubscribed", "event.received", "delivery.delivered", "delivery.opened", "delivery.clicked", "user.created", "user.updated", "conversion.created", "campaign.completed" |
event_name | string | Hayır | Uzunluk: 1–100 |
Örnek:
{
"target_url": "https://example.com/orders/1001",
"event": "subscription.created",
"event_name": "purchase"
}Yanıtlar
201 — Başarılı.
Şema: ZapierHook
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
id | string | Evet | |
event | string | Evet | |
event_name | string | null | Evet | |
target_url | string | Evet | |
last_delivered_at | string | null | Evet | |
failure_count | integer | Evet | |
created_at | string | Evet |
Örnek yanıt:
{
"id": "id_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"event": "purchase",
"event_name": "purchase",
"target_url": "https://example.com/orders/1001",
"last_delivered_at": "örnek",
"failure_count": 1,
"created_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/integrations/zapier/hooks" \
-H "Authorization: Bearer $PUSHIZO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_url": "https://example.com/orders/1001",
"event": "subscription.created",
"event_name": "purchase"
}'REST Hook aboneliğini sil (Zap kapatıldı)
Kimlik doğrulama: API anahtarı — kapsam users:read (admin her kapsamı içerir).
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
hookId | yol | string | Evet | "id_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Yanıtlar
200 — Başarılı.
Şema: IntegrationOk
| 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/integrations/zapier/hooks/id_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
-H "Authorization: Bearer $PUSHIZO_API_KEY"Tetik örnekleri (performList): son kayıtlar, abonelik gövdesiyle aynı biçim
Kimlik doğrulama: API anahtarı — kapsam users:read (admin her kapsamı içerir).
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
event | sorgu | enum | Evet | Değerler: "subscription.created", "subscription.unsubscribed", "event.received", "delivery.delivered", "delivery.opened", "delivery.clicked", "user.created", "user.updated", "conversion.created", "campaign.completed" | "subscription.created" |
event_name | sorgu | string | Hayır | Uzunluk: 1–100 | "purchase" |
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Yanıtlar
200 — Başarılı.
Şema: ZapierSamples
Tür: ZapierSamples
Örnek yanıt:
[
{
"data": {
"order_id": "1001"
},
"type": "örnek",
"id": "id_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"created_at": "örnek",
"app_id": "app_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/integrations/zapier/samples?event=subscription.created" \
-H "Authorization: Bearer $PUSHIZO_API_KEY"Veri ambarı dışa aktarımı
Veri ambarı dışa aktarımı — 10 işlem (GET /v1/apps/{appId}/warehouse-exports/tables, POST /v1/apps/{appId}/warehouse-exports/test-connection, GET /v1/apps/{appId}/warehouse-exports, …). OpenAPI 3.1.0 sözleşmesinden üretilir.
MCP taslakları
MCP taslakları — 2 işlem (POST /v1/apps/{appId}/mcp/campaign-drafts, POST /v1/apps/{appId}/mcp/segment-drafts). OpenAPI 3.1.0 sözleşmesinden üretilir.