dimgigov
c55d3080cf
CI / test (push) Has been cancelled
CI / verify (push) Has been cancelled
Clients CI / build-server (push) Has been cancelled
Clients CI / test-python (push) Has been cancelled
Clients CI / test-javascript (push) Has been cancelled
Clients CI / test-nim (push) Has been cancelled
Clients CI / test-rust (push) Has been cancelled
Documentation updates: - Fix v0.1.0 → v1.1.0 version numbers in en, ru, fa, zh docs - Add missing Window Functions, Multi-Tenant ERP, Supported Keywords sections to ru, fa, zh baraql.md (~105 lines each) - Expand Turkish and Arabic baraql.md (110 → 268 lines) - Expand Turkish and Arabic installation.md (62 → 307 lines) - Add new Bulgarian documentation files (18 new files) Client updates: - Python: Full async/await rewrite with asyncio, request queueing - Rust: Full async/await rewrite with tokio, async examples - Nim: Update README to v1.1.0 - All clients now support async patterns consistently
1.8 KiB
1.8 KiB
HTTP/REST API
JSON-базиран REST API за уеб приложения.
Базов URL
http://localhost:9470
Endpoints
GET /health
Health проверка:
curl http://localhost:9470/health
GET /ready
Readiness проверка:
curl http://localhost:9470/ready
POST /query
Изпълнение на BaraQL заявка:
curl -X POST http://localhost:9470/api/query \
-H "Content-Type: application/json" \
-d '{"query": "SELECT * FROM users WHERE age > 18"}'
Отговор:
{
"columns": ["name", "age"],
"rows": [["Alice", 30], ["Bob", 25]],
"row_count": 2,
"duration_ms": 12
}
POST /batch
Групови заявки:
curl -X POST http://localhost:9470/api/batch \
-H "Content-Type: application/json" \
-d '{"queries": ["INSERT users { name := \"Alice\" }", "INSERT users { name := \"Bob\" }"]}'
GET /schema
Преглед на схемата:
curl http://localhost:9470/api/schema
GET /metrics
Prometheus метрики:
curl http://localhost:9470/metrics
POST /explain
Обяснение на план за изпълнение:
curl -X POST http://localhost:9470/api/explain \
-H "Content-Type: application/json" \
-d '{"query": "SELECT * FROM users WHERE age > 18"}'
POST /backup
Създаване на backup:
curl -X POST http://localhost:9470/api/backup \
-H "Content-Type: application/json" \
-d '{"destination": "/backup/snapshot.db"}'
Грешки
{
"error": {
"code": "INVALID_QUERY",
"message": "Грешка в синтаксиса"
}
}
Автентикация
curl -H "Authorization: Bearer <token>" \
http://localhost:9470/api/users