Geliştir API

Fikrinizi gerçek bir uygulamaya dönüştürün: Era onu kendi yapı taşlarından kurar ya da kodlama araçlarınız deponuzu değiştirir ve Era önizlemeli bir pull request açar.

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

build.archive_project

Projeyi arşivle — Projeler listesinden kaldırır. Sitesine, deposuna ve pull request’lerine dokunulmaz.

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

• Asıl adres: POST /api/v1/actions/build.archive_project

Girdi

Ön koşullar

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

Neye yazar: build_project (update) — → archived

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.buildProjects.archiveProject("BUILD_PROJECT_ID")

era build_projects archive_project BUILD_PROJECT_ID

{
  "name": "era__build__archive_project",
  "arguments": {
    "id": "BUILD_PROJECT_ID"
  }
}

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

build.cancel_run

Yapımı durdur — Durdurur; bilgisayardaki kodlama aracı da durur. Hiçbir şey commit edilmez.

Gereken izin build:write · siler ya da geri alınamaz

• Asıl adres: POST /api/v1/actions/build.cancel_run

Girdi

Ön koşullar

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

Neye yazar: build_run (update) — → cancelled; build_project (update) — Back to ready or draft

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.buildRuns.cancelRun("BUILD_RUN_ID")

era build_runs cancel_run BUILD_RUN_ID

{
  "name": "era__build__cancel_run",
  "arguments": {
    "id": "BUILD_RUN_ID"
  }
}

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

build.complete_run

Yapımı bitir — Kurulanı kaydeder: pull request ve dosyaları ya da kurulan uygulama ve yayın adresi. Yalnızca sistem.

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

• Asıl adres: POST /api/v1/actions/build.complete_run

Girdi

Ön koşullar

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

Yayımladığı olaylar: build.run_succeeded

Neye yazar: build_run (update) — → succeeded, with its result; build_project (update) — → ready, with its preview / live address

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

build.create_project

Proje başlat — Era’nın kendi yapı taşlarından kurduğu bir uygulama ya da kodlama araçlarınla üzerinde çalıştığı bir kod deposu.

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

• Asıl adres: POST /api/v1/actions/build.create_project

Girdi

Ön koşullar

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

Yayımladığı olaylar: build.project_created

Neye yazar: build_project (insert) — Writes the project

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

{
  "ok": true,
  "result": "…",
  "events": [
    "build.project_created"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.buildProjects.createProject({
  kind: "app",
  name: "Name"
})

era build_projects create_project \
  --kind "app" \
  --name "Name"

{
  "name": "era__build__create_project",
  "arguments": {
    "kind": "app",
    "name": "Name"
  }
}

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

build.fail_run

Yapımı başarısız say — Neden ve hangi adımda durduğunu kaydeder. Yalnızca sistem.

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

• Asıl adres: POST /api/v1/actions/build.fail_run

Girdi

Ön koşullar

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

Yayımladığı olaylar: build.run_failed

Neye yazar: build_run (update) — → failed; build_project (update) — → failed, unless an earlier build left it ready

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

build.record_preview

Önizlemeyi kaydet — Pull request’in önizleme yayını göründü (Vercel, Netlify, Cloudflare Pages…). Yalnızca sistem.

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

• Asıl adres: POST /api/v1/actions/build.record_preview

Girdi

Ön koşullar

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

Yayımladığı olaylar: build.preview_ready

Neye yazar: build_run (update) — Sets the preview; build_project (update) — Sets the project’s latest preview

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

build.record_progress

Yapım ilerlemesini kaydet — Yapımı bir sonraki adıma taşır (depo hazırlanıyor, kod yazılıyor, pull request açılıyor). Yalnızca sistem.

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

• Asıl adres: POST /api/v1/actions/build.record_progress

Girdi

Ön koşullar

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

Neye yazar: build_run (update) — Status, step and where it runs

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

build.record_publish

Uygulamanın yayına alındığını kaydet — Kişi taslağı onayladı ve sitesi yayına alındı. Yalnızca sistem: yayın adresini kaydeder.

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

• Asıl adres: POST /api/v1/actions/build.record_publish

Girdi

Ön koşullar

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

Yayımladığı olaylar: build.app_published

Neye yazar: build_project (update) — → live, with its address; build_run (update) — The last app run’s "live" step done

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

build.request_run

Bir şey kur ya da değiştir — Uygulama projesinde: Era uygulamayı yapı taşlarından (modüller, iş akışları, Era’lar, site) kurar ve yayına almadan önce taslak olarak gösterir — “yayına al” dersen hemen yayına alır. Bağlı bir depo varsa kodlama aracın (Claude Code, Codex, Antigravity, Copilot, Cursor… Harness Manager’ın çalıştırdığı her biri) kodu bilgisayarında değiştirir, Era önizlemeli bir pull request açar; “mobile” Expo’dan iPhone / Android derlemesi ister.

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

• Asıl adres: POST /api/v1/actions/build.request_run

Girdi

Ön koşullar

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

Yayımladığı olaylar: build.run_requested

Neye yazar: build_run (insert) — Queues the run with its steps; build_project (update) — → building

curl -X POST https://app.getera.io/api/v1/build_projects/BUILD_PROJECT_ID/actions/request_run \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"prompt":"What to build or change"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "build.run_requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.buildProjects.requestRun("BUILD_PROJECT_ID", {
  prompt: "What to build or change"
})

era build_projects request_run BUILD_PROJECT_ID \
  --prompt "What to build or change"

{
  "name": "era__build__request_run",
  "arguments": {
    "projectId": "BUILD_PROJECT_ID",
    "prompt": "What to build or change"
  }
}

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

build.update_project

Projeyi değiştir — Adını, açıklamasını değiştir, deposunu (bir uygulamanın özel kodu da) bağla, kodlama aracını ve bilgisayarı seç ya da telefon derlemeleri için Expo projesini ayarla.

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

• Asıl adres: POST /api/v1/actions/build.update_project

Girdi

Ön koşullar

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

Neye yazar: build_project (update) — Changes the project

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.buildProjects.updateProject("BUILD_PROJECT_ID", {
  name: "Name"
})

era build_projects update_project BUILD_PROJECT_ID \
  --name "Name"

{
  "name": "era__build__update_project",
  "arguments": {
    "id": "BUILD_PROJECT_ID",
    "name": "Name"
  }
}

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

Veri modelleri

BuildProject

Tablo build_project · Kaynak build_projects

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

Birincil anahtar: id

Denetimler:

• CHECK (((harness IS NULL) OR (harness ~ '^[a-z][a-z0-9_]{1,31}$'::text)))
• CHECK ((length(btrim(name)) > 0))
• CHECK (((repo_provider IS NULL) OR (repo_provider = ANY (ARRAY['github'::text, 'gitlab'::text]))))
• CHECK (((site_state IS NULL) OR (site_state = ANY (ARRAY['draft'::text, 'live'::text]))))

BuildRun

Tablo build_run · Kaynak build_runs

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

Birincil anahtar: id

Olaylar

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