Przejdź do treści

Dokumentacja HTTP API

Ten wykaz endpointów powstaje z deklaracji tras w Pythonie przy każdym budowaniu dokumentacji. Link do funkcji prowadzi do modeli żądań i odpowiedzi. Uruchomiona bramka udostępnia pełne schematy JSON pod /openapi.json oraz interaktywną dokumentację pod /docs.

Wszystkie żądania do /api/ i /v1/ wymagają skonfigurowanej tożsamości Bearer. /api/admin/ wymaga uprawnień administracyjnych. /health jest publiczną kontrolą działania procesu; /ready sprawdza wymagane zależności semantyczne z cache (200/503, bez inferencji). Endpoint MCP /mcp/ używa tych samych zaufanych tożsamości; opisuje go kontrakt integracji.

Metoda Ścieżka Funkcja w kodzie
GET /acp/agents discovery
GET /acp/agents/{name} agent
GET /acp/ping ping
POST /acp/runs run
GET /api/admin/audit.jsonl audit_export
POST /api/admin/policies/activate activate_policy
POST /api/admin/policies/draft draft_policy
POST /api/admin/policies/preview preview_policy
PUT /api/admin/policy save_policy
POST /api/admin/reload reload_policy
POST /api/admin/rules/preview preview_rule
GET /api/admin/rules/schema rule_schema
POST /api/admin/semantic/preview preview
GET /api/admin/status status
POST /api/documents/markdown document_markdown
POST /api/invoke invoke
GET /api/me me
POST /api/models/complete complete
GET /health health
GET /ready readiness
POST /v1/chat/completions complete
GET /v1/models models

Znaczenie odpowiedzi

Odpowiedź HTTP 200 z chronionego wywołania może zawierać decyzję blocked. Sprawdź pola decision, reason i upstream_executed; sam status HTTP nie oznacza zgody na operację. Blokada odpowiedzi może nastąpić po wykonaniu operacji przez docelową usługę.

Wywołania zgodne z OpenAI zwracają schemat właściwy dla danego endpointu. Ten wykaz nie oznacza obsługi streamingu, dowolnych dostawców ani dowolnego proxy MCP. Szczegóły zawiera kontrakt protokołów.