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ètode | Ruta | Cos | Retorna |
|---|---|---|---|
| POST | /auth/signup | { email, password, name } | { token, user } |
| POST | /auth/signin | { email, password } | { token, user } |
| GET | /auth/me | — | { user } |
Base de dades
| Mètode | Ruta | Notes |
|---|---|---|
| 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ètode | Ruta | Cos |
|---|---|---|
| POST | /ai | { messages: [{role, content}], system?, json? } → { text, data? } |
| POST | /storage/upload | multipart/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ó.