E-posta teslim edilebilirliği
E-posta teslim edilebilirliği — 9 işlem (GET /v1/apps/{appId}/email-deliverability, PUT /v1/apps/{appId}/email-deliverability, POST /v1/apps/{appId}/email-deliverability/verify-address, …). OpenAPI 3.1.0 sözleşmesinden üretilir.
Gönderici alan adı doğrulaması (SPF/DKIM/DMARC), ısındırma (warm-up) planı, itibar ve bounce/şikâyet özetleri.
Taban adres: https://api.pushizo.com · Etiket: email-deliverability · Etkileşimli belge (Scalar)
İşlemler
Ayrıntılar
E-posta teslim ayarları (BCC/arşiv, gönderim öncesi adres doğrulama, üçüncü taraf doğrulayıcı)
Kimlik doğrulama: API anahtarı (Authorization: Bearer hs_live_…).
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Yanıtlar
200 — Başarılı.
Şema: EmailDeliverabilitySettings
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
bcc_address | string | null | Evet | |
validation | object | Evet | |
validation.enabled | boolean | Evet | |
validation.check_mx | boolean | Evet | |
validation.block_disposable | boolean | Evet | |
validation.block_role | boolean | Evet | |
verifier | object | Evet | |
verifier.provider | enum | null | Evet | |
verifier.has_key | boolean | Evet |
Örnek yanıt:
{
"bcc_address": "örnek",
"validation": {
"enabled": true,
"check_mx": true,
"block_disposable": true,
"block_role": true
},
"verifier": {
"provider": "zerobounce",
"has_key": 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/email-deliverability" \
-H "Authorization: Bearer $PUSHIZO_API_KEY"E-posta teslim ayarlarını güncelle (doğrulayıcı anahtarı zarf şifreli saklanır, geri okunmaz)
Kimlik doğrulama: API anahtarı (Authorization: Bearer hs_live_…).
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
İstek gövdesi (zorunlu)
Şema: DeliverabilitySettingsDto
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
bcc_address | string (email) | null | Hayır | |
validation | object | Hayır | |
validation.enabled | boolean | Evet | |
validation.check_mx | boolean | Hayır | |
validation.block_disposable | boolean | Hayır | |
validation.block_role | boolean | Hayır | |
verifier | object | Hayır | |
verifier.provider | enum | null | Evet | |
verifier.api_key | string | Hayır | Uzunluk: 8–200 |
Örnek:
{
"bcc_address": "ayse@example.com",
"validation": {
"enabled": true,
"check_mx": true,
"block_disposable": true,
"block_role": true
},
"verifier": {
"provider": "zerobounce",
"api_key": "örnek"
}
}Yanıtlar
200 — Başarılı.
Şema: EmailDeliverabilitySettings
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
bcc_address | string | null | Evet | |
validation | object | Evet | |
validation.enabled | boolean | Evet | |
validation.check_mx | boolean | Evet | |
validation.block_disposable | boolean | Evet | |
validation.block_role | boolean | Evet | |
verifier | object | Evet | |
verifier.provider | enum | null | Evet | |
verifier.has_key | boolean | Evet |
Örnek yanıt:
{
"bcc_address": "örnek",
"validation": {
"enabled": true,
"check_mx": true,
"block_disposable": true,
"block_role": true
},
"verifier": {
"provider": "zerobounce",
"has_key": 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 PUT "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/email-deliverability" \
-H "Authorization: Bearer $PUSHIZO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"bcc_address": "ayse@example.com",
"validation": {
"enabled": true,
"check_mx": true,
"block_disposable": true,
"block_role": true
},
"verifier": {
"provider": "zerobounce",
"api_key": "örnek"
}
}'Adres doğrulama testi (sözdizimi, MX, tek kullanımlık alan adı, rol hesabı, üçüncü taraf)
Kimlik doğrulama: API anahtarı (Authorization: Bearer hs_live_…).
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
İstek gövdesi (zorunlu)
Şema: VerifyAddressDto
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
address | string | Evet | Uzunluk: 3–320 |
Örnek:
{
"address": "örnek"
}Yanıtlar
200 — Başarılı.
Şema: EmailAddressCheck
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
ok | boolean | Evet | |
reason | enum | null | Evet | |
detail | string | null | Evet | |
checks | array<string> | Evet | |
unknown | array<string> | Evet |
Örnek yanıt:
{
"ok": true,
"reason": "syntax",
"detail": "örnek",
"checks": [
"örnek"
],
"unknown": [
"ö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/email-deliverability/verify-address" \
-H "Authorization: Bearer $PUSHIZO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"address": "örnek"
}'Isındırma planları (bugünkü limit/kullanım ve ileri günlere ayrılmış gönderimler)
Kimlik doğrulama: API anahtarı (Authorization: Bearer hs_live_…).
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Yanıtlar
200 — Başarılı.
Şema: EmailWarmupPlanList
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
data | array<object> | Evet | |
data[].id | string | Evet | |
data[].name | string | Evet | |
data[].kind | enum | Evet | Değerler: "domain", "ip" |
data[].target | string | Evet | |
data[].start_date | string | Evet | |
data[].daily_limits | array<integer> | Evet | |
data[].provider_shares | map<string, number> | Evet | |
data[].timezone | string | Evet | |
data[].status | enum | Evet | Değerler: "active", "paused", "completed" |
data[].today | object | Evet | |
data[].today.day | string | Evet | |
data[].today.index | integer | Evet | |
data[].today.limit | integer | null | Evet | |
data[].today.used | integer | Evet | |
data[].today.buckets | map<string, object> | Evet | |
data[].scheduled_ahead | integer | Evet | |
data[].created_at | string | Evet | |
data[].updated_at | string | Evet |
Örnek yanıt:
{
"data": [
{
"name": "Sipariş bildirimleri",
"target": "örnek",
"status": "active",
"id": "id_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"kind": "domain",
"start_date": "örnek",
"daily_limits": [
1
],
"provider_shares": {
"key": 149.9
},
"timezone": "Europe/Istanbul",
"today": {
"day": "örnek",
"index": 1,
"limit": 50,
"used": 1,
"buckets": {
"key": {}
}
},
"scheduled_ahead": 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/email-deliverability/warmup-plans" \
-H "Authorization: Bearer $PUSHIZO_API_KEY"Isındırma planı oluştur (günlük limit eğrisi veya başlangıç/çarpan/hedef; sağlayıcı payları)
Kimlik doğrulama: API anahtarı (Authorization: Bearer hs_live_…).
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
İstek gövdesi (zorunlu)
Şema: CreateWarmupPlanDto
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | Evet | Uzunluk: 1–100 |
kind | enum | Evet | Değerler: "domain", "ip" |
target | string | Evet | Uzunluk: 2–253 |
start_date | string | Hayır | |
daily_limits | array<integer> | Hayır | Öğe: 1–120 |
curve | object | Hayır | |
curve.start | integer | Evet | Aralık: 1–1000000 |
curve.growth | number | Evet | Aralık: 1.05–3 |
curve.target | integer | Evet | Aralık: 1–10000000 |
provider_shares | object | Hayır | |
provider_shares.gmail | number | Evet | Aralık: 0–1 |
provider_shares.outlook | number | Evet | Aralık: 0–1 |
provider_shares.yahoo | number | Evet | Aralık: 0–1 |
provider_shares.other | number | Evet | Aralık: 0–1 |
timezone | string | Hayır | Uzunluk: 1–64 |
Örnek:
{
"name": "Sipariş bildirimleri",
"target": "örnek",
"kind": "domain",
"start_date": "değer",
"daily_limits": [
1
],
"curve": {
"target": 1,
"start": 1,
"growth": 1.05
},
"provider_shares": {
"gmail": 1.5,
"outlook": 1.5,
"yahoo": 1.5,
"other": 1.5
},
"timezone": "Europe/Istanbul"
}Yanıtlar
201 — Başarılı.
Şema: EmailWarmupPlan
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
id | string | Evet | |
name | string | Evet | |
kind | enum | Evet | Değerler: "domain", "ip" |
target | string | Evet | |
start_date | string | Evet | |
daily_limits | array<integer> | Evet | |
provider_shares | map<string, number> | Evet | |
timezone | string | Evet | |
status | enum | Evet | Değerler: "active", "paused", "completed" |
today | object | Evet | |
today.day | string | Evet | |
today.index | integer | Evet | |
today.limit | integer | null | Evet | |
today.used | integer | Evet | |
today.buckets | map<string, object> | Evet | |
scheduled_ahead | integer | Evet | |
created_at | string | Evet | |
updated_at | string | Evet |
Örnek yanıt:
{
"name": "Sipariş bildirimleri",
"target": "örnek",
"status": "active",
"id": "id_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"kind": "domain",
"start_date": "örnek",
"daily_limits": [
1
],
"provider_shares": {
"key": 149.9
},
"timezone": "Europe/Istanbul",
"today": {
"day": "örnek",
"index": 1,
"limit": 50,
"used": 1,
"buckets": {
"key": {
"limit": 50,
"used": 1
}
}
},
"scheduled_ahead": 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/email-deliverability/warmup-plans" \
-H "Authorization: Bearer $PUSHIZO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Sipariş bildirimleri",
"target": "örnek",
"kind": "domain",
"start_date": "değer",
"daily_limits": [
1
],
"curve": {
"target": 1,
"start": 1,
"growth": 1.05
},
"provider_shares": {
"gmail": 1.5,
"outlook": 1.5,
"yahoo": 1.5,
"other": 1.5
},
"timezone": "Europe/Istanbul"
}'Isındırma planı
/v1/apps/{appId}/email-deliverability/warmup-plans/{planId}Dene (etkileşimli API belgesi, yeni sekme)Kimlik doğrulama: API anahtarı (Authorization: Bearer hs_live_…).
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
planId | yol | string | Evet | "id_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Yanıtlar
200 — Başarılı.
Şema: EmailWarmupPlan
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
id | string | Evet | |
name | string | Evet | |
kind | enum | Evet | Değerler: "domain", "ip" |
target | string | Evet | |
start_date | string | Evet | |
daily_limits | array<integer> | Evet | |
provider_shares | map<string, number> | Evet | |
timezone | string | Evet | |
status | enum | Evet | Değerler: "active", "paused", "completed" |
today | object | Evet | |
today.day | string | Evet | |
today.index | integer | Evet | |
today.limit | integer | null | Evet | |
today.used | integer | Evet | |
today.buckets | map<string, object> | Evet | |
scheduled_ahead | integer | Evet | |
created_at | string | Evet | |
updated_at | string | Evet |
Örnek yanıt:
{
"name": "Sipariş bildirimleri",
"target": "örnek",
"status": "active",
"id": "id_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"kind": "domain",
"start_date": "örnek",
"daily_limits": [
1
],
"provider_shares": {
"key": 149.9
},
"timezone": "Europe/Istanbul",
"today": {
"day": "örnek",
"index": 1,
"limit": 50,
"used": 1,
"buckets": {
"key": {
"limit": 50,
"used": 1
}
}
},
"scheduled_ahead": 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/email-deliverability/warmup-plans/id_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
-H "Authorization: Bearer $PUSHIZO_API_KEY"Isındırma planını güncelle (duraklat/sürdür, eğri, paylar)
/v1/apps/{appId}/email-deliverability/warmup-plans/{planId}Dene (etkileşimli API belgesi, yeni sekme)Kimlik doğrulama: API anahtarı (Authorization: Bearer hs_live_…).
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
planId | yol | string | Evet | "id_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
İstek gövdesi (zorunlu)
Şema: UpdateWarmupPlanDto
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | Hayır | Uzunluk: 1–100 |
status | enum | Hayır | Değerler: "active", "paused" |
daily_limits | array<integer> | Hayır | Öğe: 1–120 |
provider_shares | object | null | Hayır |
Örnek:
{
"name": "Sipariş bildirimleri",
"status": "active",
"daily_limits": [
1
],
"provider_shares": {
"gmail": 1.5,
"outlook": 1.5,
"yahoo": 1.5,
"other": 1.5
}
}Yanıtlar
200 — Başarılı.
Şema: EmailWarmupPlan
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
id | string | Evet | |
name | string | Evet | |
kind | enum | Evet | Değerler: "domain", "ip" |
target | string | Evet | |
start_date | string | Evet | |
daily_limits | array<integer> | Evet | |
provider_shares | map<string, number> | Evet | |
timezone | string | Evet | |
status | enum | Evet | Değerler: "active", "paused", "completed" |
today | object | Evet | |
today.day | string | Evet | |
today.index | integer | Evet | |
today.limit | integer | null | Evet | |
today.used | integer | Evet | |
today.buckets | map<string, object> | Evet | |
scheduled_ahead | integer | Evet | |
created_at | string | Evet | |
updated_at | string | Evet |
Örnek yanıt:
{
"name": "Sipariş bildirimleri",
"target": "örnek",
"status": "active",
"id": "id_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"kind": "domain",
"start_date": "örnek",
"daily_limits": [
1
],
"provider_shares": {
"key": 149.9
},
"timezone": "Europe/Istanbul",
"today": {
"day": "örnek",
"index": 1,
"limit": 50,
"used": 1,
"buckets": {
"key": {
"limit": 50,
"used": 1
}
}
},
"scheduled_ahead": 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/email-deliverability/warmup-plans/id_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
-H "Authorization: Bearer $PUSHIZO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Sipariş bildirimleri",
"status": "active",
"daily_limits": [
1
],
"provider_shares": {
"gmail": 1.5,
"outlook": 1.5,
"yahoo": 1.5,
"other": 1.5
}
}'Isındırma planını sil
/v1/apps/{appId}/email-deliverability/warmup-plans/{planId}Dene (etkileşimli API belgesi, yeni sekme)Kimlik doğrulama: API anahtarı (Authorization: Bearer hs_live_…).
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
planId | yol | string | Evet | "id_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/email-deliverability/warmup-plans/id_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
-H "Authorization: Bearer $PUSHIZO_API_KEY"Isındırma planı gün × sağlayıcı kullanımı
/v1/apps/{appId}/email-deliverability/warmup-plans/{planId}/usageDene (etkileşimli API belgesi, yeni sekme)Kimlik doğrulama: API anahtarı (Authorization: Bearer hs_live_…).
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
planId | yol | string | Evet | "id_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
days | sorgu | integer | Hayır | Aralık: 1–120 | 1 |
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Yanıtlar
200 — Başarılı.
Şema: EmailWarmupUsage
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
data | array<object> | Evet | |
data[].day | string | Evet | |
data[].bucket | string | Evet | |
data[].used | integer | Evet | |
data[].limit | integer | null | Evet |
Örnek yanıt:
{
"data": [
{
"day": "örnek",
"bucket": "örnek",
"used": 1,
"limit": 50
}
]
}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/email-deliverability/warmup-plans/id_01JD3W5Q7X9K2M4N6P8R0T1V3W/usage" \
-H "Authorization: Bearer $PUSHIZO_API_KEY"Konuşmalar (WhatsApp, iki yönlü SMS)
Konuşmalar (WhatsApp, iki yönlü SMS) — 11 işlem (GET /v1/apps/{appId}/conversations, GET /v1/apps/{appId}/conversations/{conversationId}, GET /v1/apps/{appId}/conversations/{conversationId}/messages, …). OpenAPI 3.1.0 sözleşmesinden üretilir.
Dynamic Content ve Data Feeds
Dynamic Content ve Data Feeds — 13 işlem (GET /v1/apps/{appId}/data-feeds, POST /v1/apps/{appId}/data-feeds, GET /v1/apps/{appId}/data-feeds/{feedId}, …). OpenAPI 3.1.0 sözleşmesinden üretilir.