77builder77
Справочник

REST API

Используйте бэкенд приложения из любого клиента.

У каждого приложения есть JSON REST API, тот же самый, которым пользуются веб-SDK и приложения на Flutter.

Base URL: https://builder77.com/api/runtime/<PROJECT_ID>

ID проекта есть в URL конструктора (/build/<PROJECT_ID>). CORS разрешён для всех источников.

Авторизация

Необязательна. Войдите, чтобы получить токен, и передавайте его в заголовке 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 }

ИИ, хранилище, 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 означает, что у владельца приложения закончились кредиты интеграций.