Žinynas

REST API

Naudok savo programėlės serverio dalį iš bet kurio kliento.

Kiekviena programėlė teikia JSON REST API — tą patį, kurį naudoja žiniatinklio SDK ir Flutter programėlės.

Base URL: https://builder77.com/api/runtime/<PROJECT_ID>

Projekto ID rasi redaktoriaus URL (/build/<PROJECT_ID>). CORS leidžiamas visiems šaltiniams.

Autentifikavimas

Neprivaloma. Prisijunk, kad gautum žetoną, ir siųsk jį kaip Authorization: Bearer <token>.

Metodas	Kelias	Turinys	Grąžina
POST	`/auth/signup`	`{ email, password, name }`	`{ token, user }`
POST	`/auth/signin`	`{ email, password }`	`{ token, user }`
GET	`/auth/me`	—	`{ user }`

Duomenų bazė

Metodas	Kelias	Pastabos
GET	`/db/<collection>`	Parametrai: `where` (URL užkoduotas JSON), `sort`, `limit`, `offset`, `mine=1` → `{ items }`
GET	`/db/<collection>/_count`	→ `{ count }`
GET	`/db/<collection>/<id>`	→ įrašas arba 404
POST	`/db/<collection>`	Turinys `{ data: {...} }` → įrašas
PATCH	`/db/<collection>/<id>`	Turinys `{ data: {...} }` (sujungimas) → įrašas
PUT	`/db/<collection>/<id>`	Turinys `{ data: {...} }` (pakeitimas) → įrašas
DELETE	`/db/<collection>/<id>`	→ `{ ok: true }`

DI, saugykla, el. paštas

Metodas	Kelias	Turinys
POST	`/ai`	`{ messages: [{role, content}], system?, json? }` → `{ text, data? }`
POST	`/storage/upload`	multipart/form-data su `file` → `{ id, url, name, size }`
POST	`/email/send`	`{ to, subject, html }` → `{ ok }`
POST	`/payments/checkout`	`{ items: [{name, amount, quantity}], currency?, returnUrl, metadata? }` → `{ url, sessionId }`
GET	`/payments/verify?session_id=`	→ `{ paid, payment }`

Pavyzdys

curl "https://builder77.com/api/runtime/PROJECT_ID/db/tasks?sort=-createdAt&limit=10"

curl -X POST "https://builder77.com/api/runtime/PROJECT_ID/db/tasks" \
  -H "Content-Type: application/json" \
  -d '{"data": {"title": "From the API", "done": false}}'

Klaidos

Klaidos grąžina JSON { "error": "message" } su 4xx/5xx būsena. 429 reiškia, kad pasiekei dažnio limitą; 402 reiškia, kad programėlės savininkui baigėsi integracijų kreditai.