Αναφορά
REST API
Χρησιμοποίησε το backend της εφαρμογής σου από οποιονδήποτε client.
Κάθε εφαρμογή διαθέτει ένα JSON REST API, το ίδιο που χρησιμοποιούν το web SDK και οι εφαρμογές Flutter.
Base URL: https://builder77.com/api/runtime/<PROJECT_ID>Το ID του project σου βρίσκεται στο URL του builder (/build/<PROJECT_ID>). Το CORS είναι ενεργό για όλες τις προελεύσεις.
Ταυτοποίηση
Προαιρετική. Συνδέσου για να πάρεις ένα token και στείλε το ως Authorization: Bearer <token>.
| Μέθοδος | Διαδρομή | Σώμα | Επιστρέφει |
|---|---|---|---|
| POST | /auth/signup | { email, password, name } | { token, user } |
| POST | /auth/signin | { email, password } | { token, user } |
| GET | /auth/me | — | { user } |
Βάση δεδομένων
| Μέθοδος | Διαδρομή | Σημειώσεις |
|---|---|---|
| GET | /db/<collection> | Παράμετροι: where (JSON κωδικοποιημένο στο URL), sort, limit, offset, mine=1 → { items } |
| GET | /db/<collection>/_count | → { count } |
| GET | /db/<collection>/<id> | → εγγραφή ή 404 |
| POST | /db/<collection> | Σώμα { data: {...} } → εγγραφή |
| PATCH | /db/<collection>/<id> | Σώμα { data: {...} } (συγχώνευση) → εγγραφή |
| PUT | /db/<collection>/<id> | Σώμα { data: {...} } (αντικατάσταση) → εγγραφή |
| DELETE | /db/<collection>/<id> | → { ok: true } |
AI, αποθήκευση, email
| Μέθοδος | Διαδρομή | Σώμα |
|---|---|---|
| POST | /ai | { messages: [{role, content}], system?, json? } → { text, data? } |
| POST | /storage/upload | multipart/form-data με 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 } |
Παράδειγμα
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}}'Σφάλματα
Τα σφάλματα επιστρέφουν JSON { "error": "message" } με κατάσταση 4xx/5xx. Το 429 σημαίνει ότι έφτασες σε όριο κλήσεων· το 402 σημαίνει ότι ο κάτοχος της εφαρμογής έμεινε χωρίς credits ενσωματώσεων.