Esta pagina centraliza os contratos OpenAPI publicados no site de docs.
Autenticacao e autorizacao
REST (fsaap-agent-api e fsaap-rag)
- Envie
Authorization: Bearer <jwt>nos endpoints protegidos. - Para API publica, use tambem os headers especificos documentados no guia (
x-public-session-token,x-correlation-id,x-idempotency-key). - Regras de autorizacao e escopo sao aplicadas no backend (RBAC + contexto de tenant/use case).
GraphQL (Hasura)
- Endpoint de consulta:
/v1/graphql - Envie
Authorization: Bearer <jwt> - O Hasura usa claims mapeados no token (
x-hasura-allowed-roles,x-hasura-default-role,x-hasura-user-id,x-hasura-org-id) - Se necessario, envie
x-hasura-rolepara selecionar uma role permitida - Permissoes de leitura seguem metadata (
select_permissions) com filtros de seguranca por role e tenant - Mutations nao sao usadas neste fluxo; operacoes de escrita ficam nos servicos REST
Servicos
Agent API
- OpenAPI (latest):
/contracts/fsaap-agent-api/latest.yaml - OpenAPI (named):
/contracts/fsaap-agent-api/fsaap-agent-api.yaml - Swagger viewer:
/swagger/?url=/contracts/fsaap-agent-api/latest.yaml - Guia GraphQL Tenant:
/docs/graphql-tenant/ - Guia GraphQL Admin:
/docs/graphql-admin/
RAG API
- OpenAPI (latest):
/contracts/fsaap-rag/latest.yaml - OpenAPI (named):
/contracts/fsaap-rag/fsaap-rag.yaml - Swagger viewer:
/swagger/?url=/contracts/fsaap-rag/latest.yaml
GraphQL (Hasura)
- Endpoint canonico de query:
/v1/graphql - Schema: obtido por introspection GraphQL (ver guias de tenant/admin)
- Guia GraphQL Tenant:
/docs/graphql-tenant/ - Guia GraphQL Admin:
/docs/graphql-admin/