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 publiczny. 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 |
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.