Referencia
REST API
Használd az alkalmazásod backendjét bármilyen kliensből.
Minden alkalmazás JSON REST API-t biztosít – ugyanazt, amelyet a web SDK és a Flutter-alkalmazások is használnak.
Base URL: https://builder77.com/api/runtime/<PROJECT_ID>A projektazonosítót a szerkesztő URL-jében találod (/build/<PROJECT_ID>). A CORS minden forrás számára engedélyezett.
Hitelesítés
Opcionális. Jelentkezz be, hogy tokent kapj, és küldd Authorization: Bearer <token> formában.
| Metódus | Útvonal | Törzs | Visszaadja |
|---|---|---|---|
| POST | /auth/signup | { email, password, name } | { token, user } |
| POST | /auth/signin | { email, password } | { token, user } |
| GET | /auth/me | – | { user } |
Adatbázis
| Metódus | Útvonal | Megjegyzés |
|---|---|---|
| GET | /db/<collection> | Paraméterek: where (URL-kódolt JSON), sort, limit, offset, mine=1 → { items } |
| GET | /db/<collection>/_count | → { count } |
| GET | /db/<collection>/<id> | → rekord vagy 404 |
| POST | /db/<collection> | Törzs: { data: {...} } → rekord |
| PATCH | /db/<collection>/<id> | Törzs: { data: {...} } (összefésülés) → rekord |
| PUT | /db/<collection>/<id> | Törzs: { data: {...} } (csere) → rekord |
| DELETE | /db/<collection>/<id> | → { ok: true } |
MI, tárhely, e-mail
| Metódus | Útvonal | Törzs |
|---|---|---|
| POST | /ai | { messages: [{role, content}], system?, json? } → { text, data? } |
| POST | /storage/upload | multipart/form-data file mezővel → { 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 } |
Példa
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}}'Hibák
A hibák JSON-t adnak vissza: { "error": "message" }, 4xx/5xx állapotkóddal. A 429 azt jelenti, hogy elérted a hívási korlátot; a 402 azt, hogy az alkalmazás tulajdonosának elfogytak az integrációs kreditjei.