Era Masaüstü API

Era Masaüstü’nüzün sohbetleri, bekleyen onaylar, planlar, yapılacaklar ve otomatik işler — Era’da, yalnızca sizin.

Modül kodu station · 6 işlem · 0 veri modeli · 6 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ı: station (hepsi), station:read (yalnız okuma) ya da station:<yetenek>.

İşlemler

station.answer_pending

Bir masaüstü isteğini yanıtla — Era Masaüstü’nün beklediği şeyi webden onaylayın, reddedin ya da yanıtlayın; masaüstü onunla devam eder.

Gereken izin station:write · veriyi değiştirir

Girdi

Ön koşullar

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

Yayımladığı olaylar: station.pending_answered

Neye yazar: station_pending (update) — Records the answer; the Station picks it up

curl -X POST https://app.getera.io/api/v1/actions/station.answer_pending \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"id":"STATION_PENDING_ID","answer":{}}'

{
  "ok": true,
  "result": "…",
  "events": [
    "station.pending_answered"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("station.answer_pending", {
  id: "STATION_PENDING_ID",
  answer: {}
})

era station answer_pending --data '{"id":"STATION_PENDING_ID","answer":{}}'

{
  "name": "era__station__answer_pending",
  "arguments": {
    "id": "STATION_PENDING_ID",
    "answer": {}
  }
}

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

station.record_batch

Masaüstü bilgilerini kaydet — Era Masaüstü’nün son gönderiminden bu yana kesinleşenler — projeler, sohbetler, bekleyen onaylar, planlar, yapılacaklar, otomatik işler — sizin adınıza Era’da tutulur.

Gereken izin station:write · veriyi değiştirir

Girdi

Ön koşullar

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

Yayımladığı olaylar: station.batch_recorded

Neye yazar: station_engine (upsert) — Locked engine sequence and projection/runtime checkpoint; station_event (insert) — Ordered settled engine facts; transient deltas are refused; station_receipt (insert) — Immutable batch acknowledgments for safe retries; station_checkpoint_part (insert) — Immutable bounded checkpoint parts; a complete manifest is activated atomically; station_space (upsert) — Spaces; station_project (upsert) — Projects (folders); station_thread (upsert) — Chat settings; a web edit newer than the device copy wins; station_pending (upsert) — Approvals and questions waiting; an answer given on the web stays; station_plan (upsert) — Proposed plans; station_todo (upsert) — Todos; station_pr_pin (upsert) — Pinned pull requests, 20 per project; station_automation (upsert) — Automations; station_automation_run (upsert) — Automation runs; station_automation_memory (upsert) — What an automation remembers

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

{
  "ok": true,
  "result": "…",
  "events": [
    "station.batch_recorded"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("station.record_batch", {
  items: {}
})

era station record_batch --data '{"items":{}}'

{
  "name": "era__station__record_batch",
  "arguments": {
    "items": {}
  }
}

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

station.toggle_automation

Bir masaüstü otomatik işini duraklat ya da sürdür — Era Masaüstü otomatik işlerinizden birinin çalışmasını durdurur ya da yeniden çalışmasına izin verir.

Gereken izin station:write · veriyi değiştirir

Girdi

Ön koşullar

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

Yayımladığı olaylar: station.automation_toggled

Neye yazar: station_automation (update) — On or off; the Station follows

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

{
  "ok": true,
  "result": "…",
  "events": [
    "station.automation_toggled"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("station.toggle_automation", {
  id: "STATION_AUTOMATION_ID",
  enabled: true
})

era station toggle_automation \
  --id "STATION_AUTOMATION_ID" \
  --enabled true

{
  "name": "era__station__toggle_automation",
  "arguments": {
    "id": "STATION_AUTOMATION_ID",
    "enabled": true
  }
}

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

station.update_automation

Bir masaüstü otomatik işini değiştir — Era Masaüstü otomatik işlerinizden birinin adını, ne istediğini ya da ne zaman çalıştığını değiştirir.

Gereken izin station:write · veriyi değiştirir

Girdi

Ön koşullar

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

Yayımladığı olaylar: station.automation_updated

Neye yazar: station_automation (update) — The person’s edit; the Station applies it

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

{
  "ok": true,
  "result": "…",
  "events": [
    "station.automation_updated"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("station.update_automation", {
  id: "STATION_AUTOMATION_ID"
})

era station update_automation \
  --id "STATION_AUTOMATION_ID"

{
  "name": "era__station__update_automation",
  "arguments": {
    "id": "STATION_AUTOMATION_ID"
  }
}

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

station.update_thread

Bir masaüstü sohbetini değiştir — Era Masaüstü sohbetlerinizden birini sabitleyin, arşivleyin, erteleyin ya da yeniden adlandırın; not ekleyin ya da çalışma alanıyla paylaşın.

Gereken izin station:write · veriyi değiştirir

Girdi

Ön koşullar

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

Yayımladığı olaylar: station.thread_updated

Neye yazar: station_thread (update) — The person’s own settings for the chat

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

{
  "ok": true,
  "result": "…",
  "events": [
    "station.thread_updated"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("station.update_thread", {
  id: "STATION_THREAD_ID"
})

era station update_thread \
  --id "STATION_THREAD_ID"

{
  "name": "era__station__update_thread",
  "arguments": {
    "id": "STATION_THREAD_ID"
  }
}

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

station.update_todo

Bir masaüstü yapılacağını değiştir — Era Masaüstü yapılacaklarınızdan birini yeniden adlandırır ya da tamamlandı olarak işaretler.

Gereken izin station:write · veriyi değiştirir

Girdi

Ön koşullar

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

Yayımladığı olaylar: station.todo_updated

Neye yazar: station_todo (update) — The person’s edit; the Station applies it

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

{
  "ok": true,
  "result": "…",
  "events": [
    "station.todo_updated"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("station.update_todo", {
  id: "STATION_TODO_ID"
})

era station update_todo \
  --id "STATION_TODO_ID"

{
  "name": "era__station__update_todo",
  "arguments": {
    "id": "STATION_TODO_ID"
  }
}

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

Olaylar

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