Referens

REST API

Använd appens backend från vilken klient som helst.

Varje app har ett JSON REST API. Det är samma API som webb-SDK:t och Flutter-apparna använder.

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

Projekt-ID:t hittar du i byggverktygets URL (/build/<PROJECT_ID>). CORS är aktiverat för alla ursprung.

Autentisering

Valfritt. Logga in för att få en token och skicka den som Authorization: Bearer <token>.

MetodSökvägBodyReturnerar
POST/auth/signup{ email, password, name }{ token, user }
POST/auth/signin{ email, password }{ token, user }
GET/auth/me–{ user }

Databas

MetodSökvägKommentar
GET/db/<collection>Parametrar: where (URL-kodad JSON), sort, limit, offset, mine=1 → { items }
GET/db/<collection>/_count→ { count }
GET/db/<collection>/<id>→ post eller 404
POST/db/<collection>Body { data: {...} } → post
PATCH/db/<collection>/<id>Body { data: {...} } (sammanfoga) → post
PUT/db/<collection>/<id>Body { data: {...} } (ersätt) → post
DELETE/db/<collection>/<id>→ { ok: true }

AI, lagring, e-post

MetodSökvägBody
POST/ai{ messages: [{role, content}], system?, json? } → { text, data? }
POST/storage/uploadmultipart/form-data med file → { id, url, name, size }
POST/email/send{ to, subject, html } → { ok }
POST/payments/checkout{ items: [{collection, id, qty} or {price, qty}], mode?, returnUrl, metadata? } → { url, sessionId }
GET/payments/verify?session_id=→ { paid, payment }
GET/payments/subscription→ { active, status, subscription }
POST/payments/portal{ returnUrl } → { url }

Exempel

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}}'

Fel

Fel returnerar JSON { "error": "message" } med en 4xx/5xx-status. 429 betyder att du har nått en anropsgräns; 402 betyder att appägaren har slut på integrationskrediter.