Códigos e eventos
Status HTTP
O status HTTP indica a classe do resultado. O código exato depende do fluxo e da configuração do ambiente.
| Status | Significado | O que fazer |
|---|---|---|
200 | Operação concluída. | — |
206 | O login exige uma etapa de MFA. | Conclua o desafio pelo linkURL. Veja Concluir o MFA. |
302, 307 | Redirecionamento, comum nos fluxos SSO. | Siga o redirecionamento no navegador. |
400 | Requisição, parâmetro, link ou grant inválido. | Confira os campos obrigatórios e os valores enviados. |
401 | Credencial ou token não aceito. | Autentique novamente e repita a chamada. |
403 | Acesso negado: permissão, regra operacional, provedor não autorizado ou host diferente do configurado. | Confira o host e as regras de acesso. |
404 | Arquivo, link ou recurso não encontrado. | Confira se o arquivo ainda está disponível e se o link não expirou. |
405 | Método HTTP não aceito pela rota. | Use um dos métodos indicados na referência. |
503 | Serviço externo de validação indisponível, por exemplo o Cloudflare Turnstile no login. | Tente novamente; se persistir, acione o administrador. |
Formato dos erros
O formato do corpo de erro varia entre endpoints. Não dependa de uma estrutura JSON única: trate primeiro o status HTTP e, quando houver, use a descrição retornada.
Erros de emissão de token
/auth/token e /oauth2/token respondem 400 com o modelo OAuthError:
{
"error": 400,
"error_description": "<motivo>",
"error_uri": "<uri-da-api>"
}O valor numérico de error descreve a condição reportada pela validação.
Eventos de sessão e transferência
As operações geram eventos de início e de término. Os identificadores abaixo ajudam a interpretar os registros de relatório e os registros exportados pelo ambiente.
| Código | Evento | Momento |
|---|---|---|
0 | STCPEVTSTARTSESSIONIN | Início de uma sessão de entrada autenticada. |
1 | STCPEVTENDSESSIONIN | Encerramento explícito da sessão. |
6 | STCPEVTSTARTRECEIVEFILE | Início do recebimento de um arquivo (upload). |
7 | STCPEVTENDRECEIVEFILE | Conclusão do processamento do upload. |
4 | STCPEVTSTARTSENDFILE | Início do envio de um arquivo (download). |
5 | STCPEVTENDSENDFILE | Conclusão do envio do arquivo. |
No relatório (/report), filterdirection=5 seleciona os eventos STCPEVTENDSENDFILE (downloads concluídos) e filterdirection=7, os eventos STCPEVTENDRECEIVEFILE (uploads concluídos).
Nota
O registro de início não garante que a operação foi concluída. Uma falha durante o processamento pode gerar o evento inicial sem o evento final correspondente.