İşler API

Bir kez iste: Era planlar, işi paralel çalışan uzmanlara böler ve kullanıp yayımlayabileceğin bitmiş işi getirir.

Modül kodu work · 23 işlem · 5 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ı: work (hepsi), work:read (yalnız okuma) ya da work:<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

work.add_step

Plana adım ekle — "Şunu da ekle": bir uzman için bir adım daha; beklediği bitince başlar.

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

• Asıl adres: POST /api/v1/actions/work.add_step

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.step_changed

Neye yazar: work_step (insert) — Adds the step, queued; work_job (update) — Reopens the plan and notes what was said

curl -X POST https://app.getera.io/api/v1/work_jobs/WORK_JOB_ID/actions/add_step \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"title":"Step","worker":"Worker"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "work.step_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workJobs.addStep("WORK_JOB_ID", {
  title: "Step",
  worker: "Worker"
})

era work_jobs add_step WORK_JOB_ID \
  --title "Step" \
  --worker "Worker"

{
  "name": "era__work__add_step",
  "arguments": {
    "jobId": "WORK_JOB_ID",
    "title": "Step",
    "worker": "Worker"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde work:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, unknown_worker, unknown_executor, unknown_credential, too_many_steps, bad_steps, bad_dependency, duplicate_step · 429 çok sık istek

work.answer_need

Seni bekleyen adımı yanıtla — Riskli bir adımı onayla (bir kez çalışır) ya da reddet (atlanır).

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

• Asıl adres: POST /api/v1/actions/work.answer_need

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.step_changed, work.job_finished, work.needs_you

Neye yazar: work_step (update) — Queues or skips the step; work_job (update) — Updates the plan’s status

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.step_changed",
    "work.job_finished",
    "work.needs_you"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workSteps.answerNeed("WORK_STEP_ID", {
  decision: "approve"
})

era work_steps answer_need WORK_STEP_ID \
  --decision "approve"

{
  "name": "era__work__answer_need",
  "arguments": {
    "id": "WORK_STEP_ID",
    "decision": "approve"
  }
}

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

work.approve_plan

Planı onayla — Başla işareti: uzmanlar hiçbir şey beklemeyen her adıma başlar.

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

• Asıl adres: POST /api/v1/actions/work.approve_plan

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.plan_approved

Neye yazar: work_job (update) — Marks the plan approved and running

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.plan_approved"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workJobs.approvePlan("WORK_JOB_ID")

era work_jobs approve_plan WORK_JOB_ID

{
  "name": "era__work__approve_plan",
  "arguments": {
    "id": "WORK_JOB_ID"
  }
}

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

work.assign_job

Bir planı birine ver — Bir planı bir kişiye ya da yeniden Era’ya verir; kimin göreceğini belirler: tüm çalışma alanı ya da yalnızca işin kişileri.

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

• Asıl adres: POST /api/v1/actions/work.assign_job

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.job_assigned

Neye yazar: work_job (update) — Writes who answers for the plan and who sees it

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.job_assigned"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workJobs.assignJob("WORK_JOB_ID", {
  assigneeUserId: "APP_USER_ID"
})

era work_jobs assign_job WORK_JOB_ID \
  --assignee-user-id "APP_USER_ID"

{
  "name": "era__work__assign_job",
  "arguments": {
    "id": "WORK_JOB_ID",
    "assigneeUserId": "APP_USER_ID"
  }
}

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

work.change_step

Bir adımı değiştir — "Bunu değiştir": henüz başlamamış bir adımı yeniden yazar.

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

• Asıl adres: POST /api/v1/actions/work.change_step

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.step_changed

Neye yazar: work_step (update) — Rewrites the step; work_job (update) — Notes what was said

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.step_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workSteps.changeStep("WORK_STEP_ID", {
  title: "Step"
})

era work_steps change_step WORK_STEP_ID \
  --title "Step"

{
  "name": "era__work__change_step",
  "arguments": {
    "id": "WORK_STEP_ID",
    "title": "Step"
  }
}

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

work.message_step

Çalışan bir ajana bir şey söyle — Bilgisayarında çalışan ajana iş sürerken mesaj gönderir ("şunu da yap", "dur, şöyle yap"); bir sonraki adımında dikkate alır.

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

• Asıl adres: POST /api/v1/actions/work.message_step

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.step_changed

Neye yazar: work_job (update) — Adds the message to the plan’s steering; work_step (update) — Shows the message as the step’s activity

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.step_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workSteps.messageStep("WORK_STEP_ID", {
  text: "Message"
})

era work_steps message_step WORK_STEP_ID \
  --text "Message"

{
  "name": "era__work__message_step",
  "arguments": {
    "id": "WORK_STEP_ID",
    "text": "Message"
  }
}

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

work.propose_skill

Era’nın öğrendiğini öner — “Era bu işten yeni bir beceri öğrendi — tutalım mı?”: işe yarayan yöntem, planın sahibini bekler. Yalnızca makine.

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

• Asıl adres: POST /api/v1/actions/work.propose_skill

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.skill_proposed

Neye yazar: work_job (update) — Writes the offer on the plan

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

work.record_fork

Ödünç bilgisayarı kaydet — Bilgisayar çalışanı kopyanın açıldığını, çalıştığını, geri verildiğini ya da açılamadığını ve süresini bildirir. Yalnızca makine.

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

• Asıl adres: POST /api/v1/actions/work.record_fork

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.fork_changed

Neye yazar: work_computer_fork (update) — Writes the copy’s state and time

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

work.record_shop_order

Era’nın verdiği siparişi kaydet — Alışveriş adımının raporu: ne alındı, tutar, kartın son dört hanesi, sipariş numarası ve sonra nerede olduğu. Asla kart numarası değil. Yalnızca makine.

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

• Asıl adres: POST /api/v1/actions/work.record_shop_order

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.order_placed, work.order_updated

Neye yazar: shop_order (update) — Writes the order, or its tracking

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

work.record_step

Bir adımın ilerlemesini kaydet — Motorun raporu: alındı, ilerleme, şu an ne yaptığı, neye ihtiyacı olduğu, sonucu. Planın durumunu çıkarır. Yalnızca sistem.

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

• Asıl adres: POST /api/v1/actions/work.record_step

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.step_changed, work.needs_you, work.job_finished, work.held

Neye yazar: work_step (update) — Writes the step’s progress, checkpoint and result; work_job (update) — Holds the plan at its time limit and derives its status from its steps

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

work.release_fork

Ödünç bilgisayarı geri ver — Adımın kopyayla işi bitti; bilgisayar çalışanı onu siler.

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

• Asıl adres: POST /api/v1/actions/work.release_fork

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.fork_requested

Neye yazar: work_computer_fork (update) — Marks it to be deleted

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.fork_requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workComputerForks.releaseFork("WORK_COMPUTER_FORK_ID")

era work_computer_forks release_fork WORK_COMPUTER_FORK_ID

{
  "name": "era__work__release_fork",
  "arguments": {
    "id": "WORK_COMPUTER_FORK_ID"
  }
}

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

work.replan_step

Bir adımın eksik girdisini yeniden planla — İhtiyaç duyduğu girdiyi bulamayan adım (dışa ya da içe aktarılacak satır yok) için onu üretecek bir adım ekler ve onu bekler. Yalnız sistem kullanır.

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

• Asıl adres: POST /api/v1/actions/work.replan_step

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.step_changed, work.needs_you, work.job_finished

Neye yazar: work_step (insert) — Adds the step that produces the missing input; work_step (update) — The consumer waits for it and goes back in line; work_job (update) — Notes the re-plan and derives the plan’s status

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde work:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 step_not_found, not_running, already_replanned, unknown_worker, unknown_executor, unknown_credential, too_many_steps, bad_steps · 429 çok sık istek

work.request_fork

Bulut bilgisayarımın bir kopyasını ödünç al — Bir adım için kendi giriş yapılmış bulut bilgisayarının kopyası — paralel uzmanların her biri kendi makinesinde çalışır.

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

• Asıl adres: POST /api/v1/actions/work.request_fork

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.fork_requested

Neye yazar: work_computer_fork (insert) — Asks the computer worker for a copy

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.fork_requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workComputerForks.requestFork({
  stepId: "WORK_STEP_ID"
})

era work_computer_forks request_fork \
  --step-id "WORK_STEP_ID"

{
  "name": "era__work__request_fork",
  "arguments": {
    "stepId": "WORK_STEP_ID"
  }
}

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

work.requeue_step

Bir adımı sıraya geri koy — Süreci kesilen adım sıraya döner; sonraki deneme son kayıt noktasından devam eder. Yalnızca makine.

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

• Asıl adres: POST /api/v1/actions/work.requeue_step

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.step_changed, work.needs_you, work.job_finished

Neye yazar: work_step (update) — Queues the step, keeping its checkpoint; work_job (update) — Derives the plan’s status

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

work.resume_job

Planı sürdür — Durmuş ya da başarısız bir planın bitmemiş adımlarını yeniden sıraya koyar.

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

• Asıl adres: POST /api/v1/actions/work.resume_job

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.job_resumed

Neye yazar: work_step (update) — Queues the stopped and failed steps again; work_job (update) — Marks the plan running

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.job_resumed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workJobs.resumeJob("WORK_JOB_ID")

era work_jobs resume_job WORK_JOB_ID

{
  "name": "era__work__resume_job",
  "arguments": {
    "id": "WORK_JOB_ID"
  }
}

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

work.retry_step

Bir adımı yeniden dene — Başarısız, durmuş ya da atlanmış bir adımı yeniden sıraya koyar.

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

• Asıl adres: POST /api/v1/actions/work.retry_step

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.step_changed

Neye yazar: work_step (update) — Queues the step again; work_job (update) — Marks the plan running

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.step_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workSteps.retryStep("WORK_STEP_ID")

era work_steps retry_step WORK_STEP_ID

{
  "name": "era__work__retry_step",
  "arguments": {
    "id": "WORK_STEP_ID"
  }
}

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

work.review_skill

Era’nın neyi tutacağına karar ver — Tut (çalışma alanının Era’ları kullanabilir), gizli tut (yalnız senin), düzelt ya da unut.

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

• Asıl adres: POST /api/v1/actions/work.review_skill

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.skill_reviewed

Neye yazar: work_job (update) — Records the decision

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.skill_reviewed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workJobs.reviewSkill("WORK_JOB_ID", {
  decision: "keep"
})

era work_jobs review_skill WORK_JOB_ID \
  --decision "keep"

{
  "name": "era__work__review_skill",
  "arguments": {
    "id": "WORK_JOB_ID",
    "decision": "keep"
  }
}

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

work.set_limits

Planın bütçesini ya da süresini değiştir — Bir planın kaç dakika çalışabileceği. Süre sınırına takılan plan kaldığı yerden devam eder.

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

• Asıl adres: POST /api/v1/actions/work.set_limits

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.limits_changed, work.needs_you, work.job_finished

Neye yazar: work_job (update) — Writes the time limit; lifts the hold it caused

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.limits_changed",
    "work.needs_you",
    "work.job_finished"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workJobs.setLimits("WORK_JOB_ID", {
  maxMinutes: 1
})

era work_jobs set_limits WORK_JOB_ID \
  --max-minutes 1

{
  "name": "era__work__set_limits",
  "arguments": {
    "id": "WORK_JOB_ID",
    "maxMinutes": 1
  }
}

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

work.set_shop_rule

Era’nın sormadan alacağı tutarı ayarla — Bu mağazada (ya da tüm mağazalarda) bu tutara kadarki alışverişler onay kartı olmadan alınır. Boş ya da 0 = her seferinde sor (varsayılan).

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

• Asıl adres: POST /api/v1/actions/work.set_shop_rule

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.shop_rule_changed

Neye yazar: shop_rule (update) — Writes or clears the person’s limit for that store

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.shop_rule_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.shopRules.setShopRule({
  store: "Store"
})

era shop_rules set_shop_rule \
  --store "Store"

{
  "name": "era__work__set_shop_rule",
  "arguments": {
    "store": "Store"
  }
}

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

work.start_job

Bir plan başlat — Era’nın tek bir istek için planı: her biri bir uzmana (geliştirici, araştırma, büyüme, pazarlama, kreatif, veri, işletme, bilgisayar) verilen numaralı adımlar; birbirini beklemeyenler aynı anda çalışır.

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

• Asıl adres: POST /api/v1/actions/work.start_job

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.job_started

Neye yazar: work_job (insert) — Writes the plan, running or waiting for approval; work_step (insert) — Writes its steps, queued

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.job_started"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workJobs.startJob({
  title: "Name",
  steps: {}
})

era work_jobs start_job --data '{"title":"Name","steps":{}}'

{
  "name": "era__work__start_job",
  "arguments": {
    "title": "Name",
    "steps": {}
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde work:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 bad_limits, bad_deliverable, empty_title, no_steps, too_many_steps, bad_steps, unknown_worker, unknown_executor, unknown_credential, bad_dependency, duplicate_step · 429 çok sık istek

work.stop_job

Planı durdur — "Dur": bitmemiş her adım durur; biten bitmiş kalır.

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

• Asıl adres: POST /api/v1/actions/work.stop_job

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.job_stopped

Neye yazar: work_step (update) — Stops every unfinished step; work_job (update) — Marks the plan stopped and notes it

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

{
  "ok": true,
  "result": "…",
  "events": [
    "work.job_stopped"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workJobs.stopJob("WORK_JOB_ID", {
  reason: "Why"
})

era work_jobs stop_job WORK_JOB_ID \
  --reason "Why"

{
  "name": "era__work__stop_job",
  "arguments": {
    "id": "WORK_JOB_ID",
    "reason": "Why"
  }
}

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

work.supervise_step

Çalışan bir adımı gözet — İş taramasının basamakları: sessiz kalan adımı dürt, kesip yeniden gönder (en çok iki kez), takılı kalırsa sana bırak, yanıtlanmamış bir onayı bir kez hatırlat. Yalnızca makine.

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

• Asıl adres: POST /api/v1/actions/work.supervise_step

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.step_changed, work.needs_you, work.job_finished

Neye yazar: work_step (update) — Writes the ladder’s state; queues a restarted step (keeping its checkpoint) or hands a stuck one to you; work_job (update) — Derives the plan’s status

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

work.use_result

Bir sonucu kullan — Bir sonuç kartının kullanıldığını ya da yayımlandığını kaydeder (kartın kendi işlemi senin adına çalışır).

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

• Asıl adres: POST /api/v1/actions/work.use_result

Girdi

Ön koşullar

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

Yayımladığı olaylar: work.result_used

Neye yazar: work_step (update) — Marks the card used or live

curl -X POST https://app.getera.io/api/v1/work_steps/WORK_STEP_ID/actions/use_result \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"card":1,"kind":"use"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "work.result_used"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.workSteps.useResult("WORK_STEP_ID", {
  card: 1,
  kind: "use"
})

era work_steps use_result WORK_STEP_ID \
  --card 1 \
  --kind "use"

{
  "name": "era__work__use_result",
  "arguments": {
    "stepId": "WORK_STEP_ID",
    "card": 1,
    "kind": "use"
  }
}

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

Veri modelleri

ShopOrder

Tablo shop_order · Kaynak shop_orders

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

Birincil anahtar: id

Denetimler:

• CHECK (((address_label IS NULL) OR (length(address_label) <= 300)))
• CHECK (((card_last4 IS NULL) OR (card_last4 ~ '^[0-9]{4}$'::text)))
• CHECK (((courier IS NULL) OR (length(courier) <= 200)))
• CHECK ((currency ~ '^[A-Z]{3}$'::text))
• CHECK (((delivery_fee_minor IS NULL) OR (delivery_fee_minor >= 0)))
• CHECK (((eta IS NULL) OR (length(eta) <= 200)))
• CHECK ((jsonb_typeof(items) = 'array'::text))
• CHECK (((order_no IS NULL) OR (length(order_no) <= 120)))
• CHECK ((length(request) <= 1000))
• CHECK ((store ~ '^[a-z_]{2,40}$'::text))
• CHECK (((total_minor IS NULL) OR (total_minor >= 0)))
• CHECK (((track_url IS NULL) OR (length(track_url) <= 2000)))

ShopRule

Tablo shop_rule · Kaynak shop_rules

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

Birincil anahtar: id

Tekil: workspace_id, user_id, store

Denetimler:

• CHECK (((ask_above_minor > 0) AND (ask_above_minor <= 10000000)))
• CHECK ((currency ~ '^[A-Z]{3}$'::text))
• CHECK ((store ~ '^(\*\|[a-z_]{2,40})$'::text))

WorkComputerFork

Tablo work_computer_fork · Kaynak work_computer_forks

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

Birincil anahtar: id

Denetimler:

• CHECK (((device_id IS NULL) OR (length(device_id) <= 200)))
• CHECK (((error IS NULL) OR (length(error) <= 500)))
• CHECK (((external_id IS NULL) OR (length(external_id) <= 200)))
• CHECK ((seconds_used >= 0))

WorkJob

Tablo work_job · Kaynak work_jobs

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

Birincil anahtar: id

Denetimler:

• CHECK ((length(goal) <= 8000))
• CHECK (((hold IS NULL) OR ((jsonb_typeof(hold) = 'object'::text) AND (hold ? 'kind'::text))))
• CHECK (((learned IS NULL) OR ((jsonb_typeof(learned) = 'object'::text) AND (learned ? 'status'::text))))
• CHECK (((max_minutes IS NULL) OR ((max_minutes >= 1) AND (max_minutes <= 10080))))
• CHECK (((next_step IS NULL) OR (length(next_step) <= 300)))
• CHECK ((jsonb_typeof(scope_ctx) = 'object'::text))
• CHECK ((jsonb_typeof(steering) = 'array'::text))
• CHECK (((summary IS NULL) OR (length(summary) <= 4000)))
• CHECK (((length(btrim(title)) >= 1) AND (length(btrim(title)) <= 200)))

WorkStep

Tablo work_step · Kaynak work_steps

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

Birincil anahtar: id

Denetimler:

• CHECK (((activity IS NULL) OR (length(activity) <= 300)))
• CHECK (((attempts >= 0) AND (attempts <= 1000)))
• CHECK (((checkpoint IS NULL) OR (jsonb_typeof(checkpoint) = 'object'::text)))
• CHECK (((error IS NULL) OR (length(error) <= 1000)))
• CHECK (((executor_ref IS NULL) OR (length(executor_ref) <= 200)))
• CHECK ((length(instruction) <= 8000))
• CHECK (((need IS NULL) OR (jsonb_typeof(need) = 'object'::text)))
• CHECK ((("position" >= 1) AND ("position" <= 50)))
• CHECK (((progress >= 0) AND (progress <= 100)))
• CHECK ((jsonb_typeof(result) = 'object'::text))
• CHECK (((jsonb_typeof(run) = 'object'::text) AND (run ? 'kind'::text)))
• CHECK (((runtime IS NULL) OR (length(runtime) <= 300)))
• CHECK (((supervision IS NULL) OR (jsonb_typeof(supervision) = 'object'::text)))
• CHECK (((length(btrim(title)) >= 1) AND (length(btrim(title)) <= 200)))

Olaylar

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