Référence
API REST
Utilisez le backend de votre application depuis n'importe quel client.
Chaque application expose une API REST en JSON — la même que celle utilisée par le SDK web et les applications Flutter.
Base URL: https://builder77.com/api/runtime/<PROJECT_ID>Vous trouverez l'ID de votre projet dans l'URL de l'outil de création (/build/<PROJECT_ID>). CORS est activé pour toutes les origines.
Authentification
Facultative. Connectez-vous pour obtenir un token et envoyez-le sous la forme Authorization: Bearer <token>.
| Méthode | Chemin | Corps | Renvoie |
|---|---|---|---|
| POST | /auth/signup | { email, password, name } | { token, user } |
| POST | /auth/signin | { email, password } | { token, user } |
| GET | /auth/me | — | { user } |
Base de données
| Méthode | Chemin | Remarques |
|---|---|---|
| GET | /db/<collection> | Paramètres : where (JSON encodé dans l'URL), sort, limit, offset, mine=1 → { items } |
| GET | /db/<collection>/_count | → { count } |
| GET | /db/<collection>/<id> | → enregistrement ou 404 |
| POST | /db/<collection> | Corps { data: {...} } → enregistrement |
| PATCH | /db/<collection>/<id> | Corps { data: {...} } (fusion) → enregistrement |
| PUT | /db/<collection>/<id> | Corps { data: {...} } (remplacement) → enregistrement |
| DELETE | /db/<collection>/<id> | → { ok: true } |
IA, stockage, e-mail
| Méthode | Chemin | Corps |
|---|---|---|
| POST | /ai | { messages: [{role, content}], system?, json? } → { text, data? } |
| POST | /storage/upload | multipart/form-data avec file → { 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 } |
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}}'Erreurs
Les erreurs renvoient du JSON { "error": "message" } avec un statut 4xx/5xx. 429 signifie que vous avez atteint une limite de débit ; 402 signifie que le propriétaire de l'application n'a plus de crédits d'intégration.