Files
Baradb/docs/de/api-http.md
T
dimgigov c95bc4cd44
CI / test (push) Has been cancelled
CI / verify (push) Has been cancelled
docs: synchronize documentation across all languages
- Add mcp.md to: bg, fa, ru, tr, zh, ar
- Add index.md to Bulgarian (bg)
- Add 24 missing German (de) documentation files

Translations for all supported languages now complete.
2026-05-17 16:29:28 +03:00

1.3 KiB

HTTP/REST API

JSON-basierte REST API für Web-Anwendungen.

Basis-URL

http://localhost:9470/api

Endpoints

GET /api/users

Alle Benutzer auflisten:

curl http://localhost:9470/api/users

Antwort:

[
  {"id": 1, "name": "Alice", "age": 30},
  {"id": 2, "name": "Bob", "age": 25}
]

GET /api/users/:id

Benutzer nach ID abrufen:

curl http://localhost:9470/api/users/1

POST /api/users

Benutzer erstellen:

curl -X POST http://localhost:9470/api/users \
  -H "Content-Type: application/json" \
  -d '{"name": "Charlie", "age": 35}'

PUT /api/users/:id

Benutzer aktualisieren:

curl -X PUT http://localhost:9470/api/users/1 \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice", "age": 31}'

DELETE /api/users/:id

Benutzer löschen:

curl -X DELETE http://localhost:9470/api/users/1

Query-Endpoint

BaraQL-Abfragen über HTTP ausführen:

curl -X POST http://localhost:9470/api/query \
  -H "Content-Type: application/json" \
  -d '{"sql": "SELECT * FROM users WHERE age > 18"}'

Fehlerantwort

{
  "error": {
    "code": "INVALID_QUERY",
    "message": "Syntax error at line 1"
  }
}

Authentifizierung

curl -H "Authorization: Bearer <token>" \
  http://localhost:9470/api/users