77builder77
Αναφορά

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/uploadmultipart/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 ενσωματώσεων.