Referència

API REST

Fes servir el backend de la teva app des de qualsevol client.

Cada app té una API REST en JSON. És la mateixa que fan servir l'SDK web i les apps Flutter.

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

L'ID del projecte és a l'URL de l'editor (/build/<PROJECT_ID>). CORS està habilitat per a tots els orígens.

Autenticació

Opcional. Inicia sessió per obtenir un token i envia'l com a Authorization: Bearer <token>.

MètodeRutaCosRetorna
POST/auth/signup{ email, password, name }{ token, user }
POST/auth/signin{ email, password }{ token, user }
GET/auth/me—{ user }

Base de dades

MètodeRutaNotes
GET/db/<collection>Paràmetres: where (JSON codificat a l'URL), sort, limit, offset, mine=1 → { items }
GET/db/<collection>/_count→ { count }
GET/db/<collection>/<id>→ registre o 404
POST/db/<collection>Cos { data: {...} } → registre
PATCH/db/<collection>/<id>Cos { data: {...} } (fusió) → registre
PUT/db/<collection>/<id>Cos { data: {...} } (substitució) → registre
DELETE/db/<collection>/<id>→ { ok: true }

IA, emmagatzematge, correu

MètodeRutaCos
POST/ai{ messages: [{role, content}], system?, json? } → { text, data? }
POST/storage/uploadmultipart/form-data amb 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 }

Exemple

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

Errors

Els errors retornen JSON { "error": "message" } amb un estat 4xx/5xx. 429 vol dir que has arribat a un límit de freqüència; 402 vol dir que el propietari de l'app s'ha quedat sense crèdits d'integració.