Altyapı API

Başka araçları bağlamak için API anahtarları, webhook’lar ve arka plan işleri.

Modül kodu platform · 19 işlem · 1 veri modeli · 16 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ı: platform (hepsi), platform:read (yalnız okuma) ya da platform:<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

platform.cancel_job

İşi iptal et — Sıradaki bir işi kuyruktan alır. Çalışmakta olan işe dokunulmaz.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.job_cancelled

Neye yazar: job (update) — Marks the job cancelled

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

{
  "ok": true,
  "result": "…",
  "events": [
    "platform.job_cancelled"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.cancel_job", {
  job_id: "JOB_ID"
})

era platform cancel_job \
  --job-id "JOB_ID"

{
  "name": "era__platform__cancel_job",
  "arguments": {
    "job_id": "JOB_ID"
  }
}

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

platform.create_api_key

API anahtarı oluştur — Bu çalışma alanı için bir anahtar üretir. Anahtarın kendisi bir kez gösterilir ve hiç saklanmaz.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.key_created

Neye yazar: api_key (insert) — Stores the digest, the prefix and who issued it

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

platform.create_webhook

Webhook kaydet — Bu çalışma alanının gönderi yaptığı ya da dış dünyanın bu alana gönderi yaptığı bir uç nokta.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.webhook_created

Neye yazar: webhook (insert) — Registers the endpoint, inactive failures counted from zero

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

{
  "ok": true,
  "result": "…",
  "events": [
    "platform.webhook_created"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.create_webhook", {
  direction: "outbound",
  name: "Name"
})

era platform create_webhook \
  --direction "outbound" \
  --name "Name"

{
  "name": "era__platform__create_webhook",
  "arguments": {
    "direction": "outbound",
    "name": "Name"
  }
}

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

platform.delete_webhook

Webhook’u kaldır — Uç noktayı ve teslimat geçmişini kaldırır.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.webhook_deleted

Neye yazar: webhook (delete) — Removes the endpoint; its deliveries cascade

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

{
  "ok": true,
  "result": "…",
  "events": [
    "platform.webhook_deleted"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.delete_webhook", {
  webhook_id: "WEBHOOK_ID"
})

era platform delete_webhook \
  --webhook-id "WEBHOOK_ID"

{
  "name": "era__platform__delete_webhook",
  "arguments": {
    "webhook_id": "WEBHOOK_ID"
  }
}

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

platform.end_session_key

Era oturum anahtarını kapat — Era’nın motorunun bir çalıştırma için kullandığı kısa ömürlü anahtarı, çalıştırma biter bitmez iptal eder.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.key_revoked

Neye yazar: api_key (update) — Stamps the session key revoked

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

platform.enqueue_job

İşi sıraya koy — Bir işçinin alacağı bir iş ekler. Aynı anahtarla yeniden sıraya koymak ilk işi döndürür.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.job_enqueued

Neye yazar: job (insert) — Adds the job, pending, due at run_at

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

{
  "ok": true,
  "result": "…",
  "events": [
    "platform.job_enqueued"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.enqueue_job", {
  type: "Type"
})

era platform enqueue_job \
  --type "Type"

{
  "name": "era__platform__enqueue_job",
  "arguments": {
    "type": "Type"
  }
}

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

platform.issue_session_key

Era oturum anahtarı başlat — Era’nın motoru isteğin üzerinde çalışırken Era’nın araçlarını senin adına kullanabilsin diye kısa ömürlü bir anahtar.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.key_created

Neye yazar: api_key (insert) — Stores the session key’s digest, scoped to Era sessions and this person

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

platform.issue_station_key

Era’nın motorunu benim için başlat — Bilgisayarınız kapalıyken Era’nın kendi motorunun sohbetlerinizi sizin adınıza yanıtlamak için kullandığı anahtar.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.key_created, platform.key_revoked

Neye yazar: api_key (insert) — Stores the engine key’s digest, scoped to Era’s engine and this person; api_key (update) — Revokes the person’s earlier engine keys

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

platform.pair_device

Bilgisayarımı bağla — Kendi bilgisayarını (Era Desktop ya da bulut bilgisayarın) Era’ya bağlar; aboneliklerin ve görevlerin orada çalışır.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.key_created, platform.key_revoked

Neye yazar: api_key (insert) — Stores the device key’s digest, scoped to this computer and this person; api_key (update) — Revokes the person’s earlier pairing of the same computer

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

platform.purge_history

Teslimat geçmişini temizle — Saklama süresinden eski teslimat kayıtlarını ve süresi dolan tekrar koruma anahtarlarını kaldırır.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.history_purged

Neye yazar: webhook_delivery (delete) — Removes delivery attempts older than the window; idempotency_key (delete) — Removes keys whose window has passed

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.purge_history", {
  days: 1
})

era platform purge_history \
  --days 1

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

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde platform: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

platform.record_delivery

Webhook teslimatını kaydet — Her deneme için yanıt ve süresiyle bir satır.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.delivery_recorded, platform.webhook_disabled

Neye yazar: webhook_delivery (insert) — Writes the attempt; webhook (update) — Moves the consecutive-failure count, and disables the endpoint when it crosses the threshold

curl -X POST https://app.getera.io/api/v1/actions/platform.record_delivery \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"webhook_id":"WEBHOOK_ID","event_name":"Event","success":true}'

{
  "ok": true,
  "result": "…",
  "events": [
    "platform.delivery_recorded",
    "platform.webhook_disabled"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.record_delivery", {
  webhook_id: "WEBHOOK_ID",
  event_name: "Event",
  success: true
})

era platform record_delivery \
  --webhook-id "WEBHOOK_ID" \
  --event-name "Event" \
  --success true

{
  "name": "era__platform__record_delivery",
  "arguments": {
    "webhook_id": "WEBHOOK_ID",
    "event_name": "Event",
    "success": true
  }
}

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

platform.rename_api_key

API anahtarını yeniden adlandır — Üretildikten sonra bir anahtarı tanımlayan tek şey adıdır.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.key_renamed

Neye yazar: api_key (update) — Changes the key’s name

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

{
  "ok": true,
  "result": "…",
  "events": [
    "platform.key_renamed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.rename_api_key", {
  key_id: "KEY_ID",
  name: "Name"
})

era platform rename_api_key \
  --key-id "KEY_ID" \
  --name "Name"

{
  "name": "era__platform__rename_api_key",
  "arguments": {
    "key_id": "KEY_ID",
    "name": "Name"
  }
}

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

platform.retry_job

İşi yeniden dene — Başarısız bir işi, hemen çalışmak üzere sıraya geri koyar.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.job_retried

Neye yazar: job (update) — Returns the job to pending, due now, and raises its attempt ceiling by one

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

{
  "ok": true,
  "result": "…",
  "events": [
    "platform.job_retried"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.retry_job", {
  job_id: "JOB_ID"
})

era platform retry_job \
  --job-id "JOB_ID"

{
  "name": "era__platform__retry_job",
  "arguments": {
    "job_id": "JOB_ID"
  }
}

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

platform.revoke_api_key

API anahtarını iptal et — Anahtarı hemen çalışmaz hâle getirir. Kayıt, eski istekler açıklanabilsin diye kalır.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.key_revoked

Neye yazar: api_key (update) — Stamps the key revoked, and by whom

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

{
  "ok": true,
  "result": "…",
  "events": [
    "platform.key_revoked"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.revoke_api_key", {
  key_id: "KEY_ID"
})

era platform revoke_api_key \
  --key-id "KEY_ID"

{
  "name": "era__platform__revoke_api_key",
  "arguments": {
    "key_id": "KEY_ID"
  }
}

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

platform.rotate_webhook_secret

İmzalama anahtarını yenile — Yeni bir gizli anahtar üretir. Eskisi 24 saat daha çalışır.

Gereken izin platform:manage · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır) · Era çalıştırırken bir kişiye onaylatır

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.webhook_secret_rotated

Neye yazar: webhook (update) — Moves the current secret to the overlap slot and stores the new one

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

{
  "ok": true,
  "result": "…",
  "events": [
    "platform.webhook_secret_rotated"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.rotate_webhook_secret", {
  webhook_id: "WEBHOOK_ID"
})

era platform rotate_webhook_secret \
  --webhook-id "WEBHOOK_ID"

{
  "name": "era__platform__rotate_webhook_secret",
  "arguments": {
    "webhook_id": "WEBHOOK_ID"
  }
}

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

platform.send_test_delivery

Test gönder veya teslimatı tekrarla — Uç noktaya imzalı bir teslimat sıraya koyar. Tekrarlamada o denemenin gövdesini aynen yeniden gönderir.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.test_delivery_queued

Neye yazar: job (insert) — Queues an apps.deliver job for the endpoint

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

{
  "ok": true,
  "result": "…",
  "events": [
    "platform.test_delivery_queued"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.send_test_delivery", {
  webhook_id: "WEBHOOK_ID"
})

era platform send_test_delivery \
  --webhook-id "WEBHOOK_ID"

{
  "name": "era__platform__send_test_delivery",
  "arguments": {
    "webhook_id": "WEBHOOK_ID"
  }
}

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

platform.set_webhook_active

Webhook’u aç veya kapat — Yeniden açmak hata sayacını sıfırlar; kapatma eşiği baştan başlar.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.webhook_enabled, platform.webhook_disabled

Neye yazar: webhook (update) — Flips the active flag and, when enabling, resets the failure count

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

{
  "ok": true,
  "result": "…",
  "events": [
    "platform.webhook_enabled",
    "platform.webhook_disabled"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.set_webhook_active", {
  webhook_id: "WEBHOOK_ID",
  active: true
})

era platform set_webhook_active \
  --webhook-id "WEBHOOK_ID" \
  --active true

{
  "name": "era__platform__set_webhook_active",
  "arguments": {
    "webhook_id": "WEBHOOK_ID",
    "active": true
  }
}

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

platform.unpair_device

Bilgisayarımı kaldır — Kendi bilgisayarlarından birinin Era bağlantısını keser. Oradaki girişlerin bilgisayarda kalır.

Gereken izin platform:read · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır) · Era çalıştırırken bir kişiye onaylatır

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.key_revoked

Neye yazar: api_key (update) — Stamps the device key revoked, and by whom

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

{
  "ok": true,
  "result": "…",
  "events": [
    "platform.key_revoked"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.unpair_device", {
  key_id: "KEY_ID"
})

era platform unpair_device \
  --key-id "KEY_ID"

{
  "name": "era__platform__unpair_device",
  "arguments": {
    "key_id": "KEY_ID"
  }
}

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

platform.update_webhook

Webhook’u düzenle — Ad, adres, olaylar, zaman aşımı, deneme sayısı ve gelen istek sınırı.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: platform.webhook_updated

Neye yazar: webhook (update) — Rewrites the endpoint’s settings

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

{
  "ok": true,
  "result": "…",
  "events": [
    "platform.webhook_updated"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("platform.update_webhook", {
  webhook_id: "WEBHOOK_ID"
})

era platform update_webhook \
  --webhook-id "WEBHOOK_ID"

{
  "name": "era__platform__update_webhook",
  "arguments": {
    "webhook_id": "WEBHOOK_ID"
  }
}

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

Veri modelleri

EventSubscriberSkip

Tablo event_subscriber_skip · Kaynak event_subscriber_skips

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

Birincil anahtar: event_id, subscriber

Olaylar

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