Bildirimler API

Kimin neden haberdar edileceği — e-posta, SMS, WhatsApp veya uygulama içi.

Modül kodu notifications · 20 işlem · 7 veri modeli · 18 olay. Bir anahtar ya da token, arkasındaki kişinin bu modülde yapabildiğinden fazlasını asla yapamaz; satır düzeyindeki güvenlik uygulamadakiyle birebir aynıdır. Yetki kapsamları: notifications (hepsi), notifications:read (yalnız okuma) ya da notifications:<yetenek>.

Kaynaklar

Listeler limit (en çok 200), cursor, order (ör. -created_at), fields ve q alır; diğer her sorgu parametresi bir sütun süzgecidir: ?status=paid, ?total[gte]=100, ?id[in]=a,b, ?x=null.

İşlemler

notifications.create_channel

Teslimat kanalı ekle — Bildirimlerin gittiği yer: bir webhook, bir adres listesi, bir Slack kanalı veya bir push uç noktası.

Gereken izin notifications:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/notifications.create_channel

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.channel_created

Neye yazar: notification_channel (insert) — Adds the channel, unverified until something has reached it

curl -X POST https://app.getera.io/api/v1/notification_channels/actions/create_channel \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"type":"webhook","name":"Name"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.channel_created"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationChannels.createChannel({
  type: "webhook",
  name: "Name"
})

era notification_channels create_channel \
  --type "webhook" \
  --name "Name"

{
  "name": "era__notifications__create_channel",
  "arguments": {
    "type": "webhook",
    "name": "Name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 invalid_url, insecure_url, url_required, recipients_required, too_many_recipients, invalid_config, name_taken · 429 çok sık istek

notifications.create_rule

Bildirim kuralı ekle — Hangi olayların hangi kanala veya kişiye, hangi sözlerle ve ne sıklıkta ulaşacağı.

Gereken izin notifications:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/notifications.create_rule

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.rule_created

Neye yazar: notification_rule (insert) — Adds the rule, active

curl -X POST https://app.getera.io/api/v1/notification_rules/actions/create_rule \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"name":"Name"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.rule_created"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationRules.createRule({
  name: "Name"
})

era notification_rules create_rule \
  --name "Name"

{
  "name": "era__notifications__create_rule",
  "arguments": {
    "name": "Name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 channel_not_found, trace_needs_webhook, invalid_condition, cooldown_out_of_range, name_taken, rule_limit_reached, recipient_incomplete · 429 çok sık istek

notifications.delete_channel

Teslimat kanalını kaldır — Bir kural hâlâ ona bağlıyken reddedilir; hiçbir kural sessizce sahipsiz kalmaz.

Gereken izin notifications:delete · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/notifications.delete_channel

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.channel_deleted

Neye yazar: notification_channel (delete) — Removes the channel

curl -X POST https://app.getera.io/api/v1/notification_channels/actions/delete_channel \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"channel_id":"CHANNEL_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.channel_deleted"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationChannels.deleteChannel({
  channel_id: "CHANNEL_ID"
})

era notification_channels delete_channel \
  --channel-id "CHANNEL_ID"

{
  "name": "era__notifications__delete_channel",
  "arguments": {
    "channel_id": "CHANNEL_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 channel_not_found, channel_in_use · 429 çok sık istek

notifications.delete_rule

Bildirim kuralını kaldır — Kuralı ve teslimat geçmişini kaldırır. Kanal kalır.

Gereken izin notifications:delete · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/notifications.delete_rule

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.rule_deleted

Neye yazar: notification_rule (delete) — Removes the rule; its deliveries cascade

curl -X POST https://app.getera.io/api/v1/notification_rules/actions/delete_rule \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"rule_id":"RULE_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.rule_deleted"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationRules.deleteRule({
  rule_id: "RULE_ID"
})

era notification_rules delete_rule \
  --rule-id "RULE_ID"

{
  "name": "era__notifications__delete_rule",
  "arguments": {
    "rule_id": "RULE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 rule_not_found · 429 çok sık istek

notifications.mark_read

Bildirimleri okundu işaretle — Uygulama içi bildirimlerinizin bir kısmını veya tamamını okundu işaretler (ya da birini yeniden okunmadı yapar).

Gereken izin notifications:read · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/notifications.mark_read

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.inbox_read

Neye yazar: notification_inbox (update) — Stamps read_at on your notifications

curl -X POST https://app.getera.io/api/v1/notification_inboxes/actions/mark_read \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"ids":"Notifications"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.inbox_read"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationInboxes.markRead({
  ids: "Notifications"
})

era notification_inboxes mark_read \
  --ids "Notifications"

{
  "name": "era__notifications__mark_read",
  "arguments": {
    "ids": "Notifications"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:read izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 notification_not_found · 429 çok sık istek

notifications.purge_history

Teslimat geçmişini temizle — Saklama süresinden eski tamamlanmış teslimatları kaldırır. Bekleyenlere asla dokunulmaz.

Gereken izin notifications:delete · siler ya da geri alınamaz

• Asıl adres: POST /api/v1/actions/notifications.purge_history

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.history_purged

Neye yazar: notification_delivery (delete) — Removes delivered, failed and suppressed rows older than the window

curl -X POST https://app.getera.io/api/v1/notification_deliveries/actions/purge_history \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"days":1}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.history_purged"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationDeliveries.purgeHistory({
  days: 1
})

era notification_deliveries purge_history \
  --days 1

{
  "name": "era__notifications__purge_history",
  "arguments": {
    "days": 1
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 retention_too_short · 429 çok sık istek

notifications.queue_delivery

Bildirimi sıraya koy — Teslimatı yazar ya da neden bilerek gönderilmediğini yazar.

Gereken izin notifications:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/notifications.queue_delivery

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.queued, notifications.suppressed

Neye yazar: notification_delivery (insert) — Writes the delivery as pending, or as suppressed with a reason; notification_rule (update) — Stamps the rule’s quiet period when it fires; notification_inbox (insert) — Puts an in-app notification in each person’s bell

curl -X POST https://app.getera.io/api/v1/notification_deliveries/actions/queue_delivery \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"rule_id":"RULE_ID","event_name":"Event"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.queued",
    "notifications.suppressed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationDeliveries.queueDelivery({
  rule_id: "RULE_ID",
  event_name: "Event"
})

era notification_deliveries queue_delivery \
  --rule-id "RULE_ID" \
  --event-name "Event"

{
  "name": "era__notifications__queue_delivery",
  "arguments": {
    "rule_id": "RULE_ID",
    "event_name": "Event"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 rule_not_found, event_not_matched · 429 çok sık istek

notifications.record_site_email

Site e-postasını kaydet — Web sitesinin müşteriye hemen gönderdiği e-posta, gönderim kaydına yazılır.

Gereken izin notifications:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/notifications.record_site_email

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: notification_delivery (insert) — Writes the delivered (or failed) email row

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 invalid_recipient · 429 çok sık istek

notifications.reset_email_template

Varsayılan metni geri yükle — Bu çalışma alanının müşteri e-postası metnini bırakır; varsayılan yeniden geçerli olur.

Gereken izin notifications:manage · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/notifications.reset_email_template

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.email_template_changed

Neye yazar: notification_email_template (delete) — Removes the workspace’s wording

curl -X POST https://app.getera.io/api/v1/notification_email_templates/actions/reset_email_template \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"kind":"Email"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.email_template_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationEmailTemplates.resetEmailTemplate({
  kind: "Email"
})

era notification_email_templates reset_email_template \
  --kind "Email"

{
  "name": "era__notifications__reset_email_template",
  "arguments": {
    "kind": "Email"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 unknown_email_template · 429 çok sık istek

notifications.retry_delivery

Bildirimi yeniden dene — Başarısız bir teslimatı, deneme sayısı sıfırlanmış olarak hemen gönderilmek üzere sıraya geri koyar.

Gereken izin notifications:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/notifications.retry_delivery

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.delivery_retried

Neye yazar: notification_delivery (update) — Returns the delivery to pending, due now

curl -X POST https://app.getera.io/api/v1/notification_deliveries/actions/retry_delivery \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"delivery_id":"DELIVERY_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.delivery_retried"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationDeliveries.retryDelivery({
  delivery_id: "DELIVERY_ID"
})

era notification_deliveries retry_delivery \
  --delivery-id "DELIVERY_ID"

{
  "name": "era__notifications__retry_delivery",
  "arguments": {
    "delivery_id": "DELIVERY_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 delivery_not_found, delivery_not_failed · 429 çok sık istek

notifications.save_email_template

Müşteri e-postasını kaydet — Bu çalışma alanı için bir müşteri e-postasının metnini değiştirir.

Gereken izin notifications:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/notifications.save_email_template

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.email_template_changed

Neye yazar: notification_email_template (upsert) — Writes the workspace’s wording

curl -X POST https://app.getera.io/api/v1/notification_email_templates/actions/save_email_template \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"kind":"Email","subject":"Subject","body":"Body"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.email_template_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationEmailTemplates.saveEmailTemplate({
  kind: "Email",
  subject: "Subject",
  body: "Body"
})

era notification_email_templates save_email_template \
  --kind "Email" \
  --subject "Subject" \
  --body "Body"

{
  "name": "era__notifications__save_email_template",
  "arguments": {
    "kind": "Email",
    "subject": "Subject",
    "body": "Body"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 unknown_email_template · 429 çok sık istek

notifications.send_customer_message

Müşteriye mesaj gönder — Bir müşteriye tek bir mesaj sıraya koyar — bağlı gelen kutusundan WhatsApp ya da SMS, markalı e-posta, ya da üçünün en uygunu.

Gereken izin notifications:handle · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/notifications.send_customer_message

Girdi

Yayımladığı olaylar: notifications.queued

Neye yazar: notification_delivery (insert) — Writes a pending delivery to one customer on one medium

curl -X POST https://app.getera.io/api/v1/notification_deliveries/actions/send_customer_message \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"customer_id":"CUSTOMER_ID","medium":"sms","text":"Message","event_name":"Event"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.queued"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationDeliveries.sendCustomerMessage({
  customer_id: "CUSTOMER_ID",
  medium: "sms",
  text: "Message",
  event_name: "Event"
})

era notification_deliveries send_customer_message \
  --customer-id "CUSTOMER_ID" \
  --medium "sms" \
  --text "Message" \
  --event-name "Event"

{
  "name": "era__notifications__send_customer_message",
  "arguments": {
    "customer_id": "CUSTOMER_ID",
    "medium": "sms",
    "text": "Message",
    "event_name": "Event"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 429 çok sık istek

notifications.send_email

E-posta gönder — Bir e-posta kanalı ve gerçek gönderici üzerinden tek bir adrese tek bir mesaj sıraya koyar.

Gereken izin notifications:handle · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/notifications.send_email

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.queued

Neye yazar: notification_delivery (insert) — Writes a pending delivery addressed to one recipient

curl -X POST https://app.getera.io/api/v1/notification_deliveries/actions/send_email \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"to":"To","subject":"Subject","text":"Message","event_name":"Event"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.queued"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationDeliveries.sendEmail({
  to: "To",
  subject: "Subject",
  text: "Message",
  event_name: "Event"
})

era notification_deliveries send_email \
  --to "To" \
  --subject "Subject" \
  --text "Message" \
  --event-name "Event"

{
  "name": "era__notifications__send_email",
  "arguments": {
    "to": "To",
    "subject": "Subject",
    "text": "Message",
    "event_name": "Event"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 invalid_recipient, no_email_channel, bad_connection · 429 çok sık istek

notifications.send_test

Test bildirimi gönder — Gerçek gönderici üzerinden kanala tek bir mesaj sıraya koyar ve sonucu kaydeder.

Gereken izin notifications:manage · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/notifications.send_test

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.test_queued

Neye yazar: notification_delivery (insert) — Writes a pending test delivery

curl -X POST https://app.getera.io/api/v1/notification_deliveries/actions/send_test \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"channel_id":"NOTIFICATION_CHANNEL_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.test_queued"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationDeliveries.sendTest({
  channel_id: "NOTIFICATION_CHANNEL_ID"
})

era notification_deliveries send_test \
  --channel-id "NOTIFICATION_CHANNEL_ID"

{
  "name": "era__notifications__send_test",
  "arguments": {
    "channel_id": "NOTIFICATION_CHANNEL_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 channel_not_found · 429 çok sık istek

notifications.send_test_email_template

Test e-postası gönder — Örnek değerlerle doldurulmuş bir müşteri e-postasını seçtiğiniz adrese gönderir.

Gereken izin notifications:manage · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/notifications.send_test_email_template

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.test_queued

Neye yazar: notification_delivery (insert) — Writes a pending test delivery to one address

curl -X POST https://app.getera.io/api/v1/notification_deliveries/actions/send_test_email_template \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"kind":"Email","to":"Send to"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.test_queued"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationDeliveries.sendTestEmailTemplate({
  kind: "Email",
  to: "Send to"
})

era notification_deliveries send_test_email_template \
  --kind "Email" \
  --to "Send to"

{
  "name": "era__notifications__send_test_email_template",
  "arguments": {
    "kind": "Email",
    "to": "Send to"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 unknown_email_template, invalid_recipient, no_email_channel · 429 çok sık istek

notifications.set_preference

Bildirim tercihini ayarla — Birinin haberdar edilip edilmeyeceği, hangi kanal türünden ve ne zamana kadar sessize alındığı.

Gereken izin notifications:read · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/notifications.set_preference

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.preference_changed

Neye yazar: notification_preference (upsert) — Writes the person’s preference for that channel type and event

curl -X POST https://app.getera.io/api/v1/notification_preferences/actions/set_preference \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"channel_type":"webhook","enabled":true}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.preference_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationPreferences.setPreference({
  channel_type: "webhook",
  enabled: true
})

era notification_preferences set_preference \
  --channel-type "webhook" \
  --enabled true

{
  "name": "era__notifications__set_preference",
  "arguments": {
    "channel_type": "webhook",
    "enabled": true
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:read izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_your_preference, not_a_member, mute_in_past · 429 çok sık istek

notifications.set_rule_active

Kuralı aç veya kapat — Kapalı bir kural hiçbir şeyle eşleşmez ve hiçbir şey sıraya koymaz.

Gereken izin notifications:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/notifications.set_rule_active

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.rule_enabled, notifications.rule_disabled

Neye yazar: notification_rule (update) — Flips the active flag and clears the quiet period

curl -X POST https://app.getera.io/api/v1/notification_rules/actions/set_rule_active \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"rule_id":"RULE_ID","active":true}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.rule_enabled",
    "notifications.rule_disabled"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationRules.setRuleActive({
  rule_id: "RULE_ID",
  active: true
})

era notification_rules set_rule_active \
  --rule-id "RULE_ID" \
  --active true

{
  "name": "era__notifications__set_rule_active",
  "arguments": {
    "rule_id": "RULE_ID",
    "active": true
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 rule_not_found, no_change · 429 çok sık istek

notifications.set_user_settings

Bildirim programımı ayarla — Bir kişi için saat dilimi, dil, sessiz saatler ve e-posta özeti.

Gereken izin notifications:read · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/notifications.set_user_settings

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.settings_changed

Neye yazar: notification_user_setting (upsert) — Writes the person’s schedule

curl -X POST https://app.getera.io/api/v1/notification_user_settings/actions/set_user_settings \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"user_id":"USER_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.settings_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationUserSettings.setUserSettings({
  user_id: "USER_ID"
})

era notification_user_settings set_user_settings \
  --user-id "USER_ID"

{
  "name": "era__notifications__set_user_settings",
  "arguments": {
    "user_id": "USER_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:read izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_your_preference, not_a_member, invalid_timezone, invalid_quiet_hours · 429 çok sık istek

notifications.settle_delivery

Teslimat sonucunu kaydet — Teslimatı tamamlandı işaretler ya da sonraki denemeyi planlar.

Gereken izin notifications:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/notifications.settle_delivery

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.delivered, notifications.delivery_failed

Neye yazar: notification_delivery (update) — Records the outcome and, on a retryable failure, when to try again; notification_channel (update) — Stamps verified_at the first time something reaches the channel

curl -X POST https://app.getera.io/api/v1/notification_deliveries/actions/settle_delivery \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"delivery_id":"DELIVERY_ID","success":true}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.delivered",
    "notifications.delivery_failed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationDeliveries.settleDelivery({
  delivery_id: "DELIVERY_ID",
  success: true
})

era notification_deliveries settle_delivery \
  --delivery-id "DELIVERY_ID" \
  --success true

{
  "name": "era__notifications__settle_delivery",
  "arguments": {
    "delivery_id": "DELIVERY_ID",
    "success": true
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 delivery_not_found, delivery_already_settled · 429 çok sık istek

notifications.update_rule

Bildirim kuralını düzenle — Kuralın olaylarını, alıcılarını, metnini veya bekleme süresini değiştirir.

Gereken izin notifications:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/notifications.update_rule

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: notifications.rule_updated

Neye yazar: notification_rule (update) — Rewrites the rule’s events, recipients and wording

curl -X POST https://app.getera.io/api/v1/notification_rules/NOTIFICATION_RULE_ID/actions/update_rule \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"name":"Name"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "notifications.rule_updated"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.notificationRules.updateRule("NOTIFICATION_RULE_ID", {
  name: "Name"
})

era notification_rules update_rule NOTIFICATION_RULE_ID \
  --name "Name"

{
  "name": "era__notifications__update_rule",
  "arguments": {
    "rule_id": "NOTIFICATION_RULE_ID",
    "name": "Name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde notifications:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 rule_not_found, channel_not_found, name_taken, cooldown_out_of_range, recipient_incomplete · 429 çok sık istek

Veri modelleri

NotificationChannel

Tablo notification_channel · Kaynak notification_channels

• GET /api/v1/notification_channels
• GET /api/v1/notification_channels/{id}

Birincil anahtar: id

Tekil: workspace_id, type, name

NotificationDelivery

Tablo notification_delivery · Kaynak notification_deliveries

• GET /api/v1/notification_deliveries
• GET /api/v1/notification_deliveries/{id}

Birincil anahtar: id

Denetimler:

• CHECK (((attempts >= 0) AND (attempts <= 10)))
• CHECK (((medium <> 'channel'::text) OR (channel_id IS NOT NULL)))
• CHECK (((rule_id IS NOT NULL) OR is_test OR (payload ? 'to'::text) OR (payload ? 'customerId'::text)))
• CHECK (((response_status IS NULL) OR ((response_status >= 100) AND (response_status < 600))))
• CHECK (((state = 'suppressed'::os.notification_delivery_state) = (suppressed_reason IS NOT NULL)))

NotificationEmailTemplate

Tablo notification_email_template · Kaynak notification_email_templates

• GET /api/v1/notification_email_templates
• GET /api/v1/notification_email_templates/{id}

Birincil anahtar: id

Tekil: workspace_id, kind

Denetimler:

• CHECK (((length(body) >= 1) AND (length(body) <= 20000)))
• CHECK (((length(subject) >= 1) AND (length(subject) <= 300)))

NotificationInbox

Tablo notification_inbox · Kaynak notification_inboxes

• GET /api/v1/notification_inboxes
• GET /api/v1/notification_inboxes/{id}

Birincil anahtar: id

NotificationPreference

Tablo notification_preference · Kaynak notification_preferences

• GET /api/v1/notification_preferences
• GET /api/v1/notification_preferences/{id}

Birincil anahtar: id

Tekil: workspace_id, user_id, channel_type, event_name

NotificationRule

Tablo notification_rule · Kaynak notification_rules

• GET /api/v1/notification_rules
• GET /api/v1/notification_rules/{id}

Birincil anahtar: id

Tekil: workspace_id, name

Denetimler:

• CHECK (((category = ''::text) OR (category ~ '^[a-z][a-z0-9_]{1,40}$'::text)))
• CHECK (((recipient = 'channel'::text) = (channel_id IS NOT NULL)))
• CHECK (((cooldown_minutes >= 0) AND (cooldown_minutes <= 10080)))
• CHECK ((mediums <@ ARRAY['in_app'::text, 'email'::text, 'sms'::text, 'whatsapp'::text]))

NotificationUserSetting

Tablo notification_user_setting · Kaynak notification_user_settings

• GET /api/v1/notification_user_settings
• GET /api/v1/notification_user_settings/{id}

Birincil anahtar: id

Tekil: workspace_id, user_id

Denetimler:

• CHECK (((digest = ANY (ARRAY['off'::text, 'hourly'::text, 'daily'::text])) AND ((digest_hour >= 0) AND (digest_hour <= 23))))
• CHECK (((quiet_start IS NULL) = (quiet_end IS NULL)))

Olaylar

İş akışları ve webhook'lar bu olaylara tepki verir.