> For the complete documentation index, see [llms.txt](https://docs.supria.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.supria.com/devs/api-de-consulta/api-de-auditoria.md).

# API De Auditoria

Esta API traz os dados do módulo de Auditoria do Supria Workspaces: as auditorias realizadas, as respostas dadas em cada item do checklist, as não conformidades encontradas e toda a configuração que define como uma auditoria é feita.

Cada auditoria pode estar ligada a um projeto, veja a API de Projetos, e é feita a partir de um tipo de auditoria, que define as categorias, as perguntas, as opções de resposta e os níveis de severidade. Quando uma resposta indica uma não conformidade, ela pode gerar uma ação corretiva no Action Hub, veja a API de Action Hub.

Por onde começar: use o endpoint Audits para listar as auditorias e seus dados principais, como status, pontuação e se houve não conformidades. A partir daí, Audit Checklist Items traz as respostas de cada pergunta, e Audit Audit Categories, Audit Signatures e Audit Trail Entries complementam cada auditoria. Audit Types, Audit Categories, Audit Questions, Audit Response Options, Audit Severity Levels, Audit Locations, Audit Field Defs e Responsibility Matrices são informações de configuração, usadas para dar nome e significado aos identificadores das auditorias.

O que você vai encontrar aqui:

* Audits — as auditorias realizadas: projeto, tipo, local, fornecedor, auditor, status, pontuação e indicação de não conformidades.
* Audit Checklist Items — as respostas de cada pergunta do checklist de uma auditoria, incluindo a opção escolhida, a severidade e se a resposta é uma não conformidade.
* Audit Audit Categories — as categorias aplicadas a cada auditoria, com o peso de pontuação vigente no momento da auditoria.
* Audit Signatures — as assinaturas registradas em cada auditoria.
* Audit Trail Entries — o histórico de eventos de cada auditoria: quem fez o quê e quando.
* Audit Types — os tipos de auditoria configurados, que definem categorias, opções de resposta, níveis de severidade e campos.
* Audit Categories — as categorias de perguntas de cada tipo de auditoria e seus pesos de pontuação.
* Audit Questions — as perguntas cadastradas em cada categoria.
* Audit Response Options — as opções de resposta de cada tipo de auditoria e se elas caracterizam uma não conformidade.
* Audit Severity Levels — os níveis de severidade de cada tipo de auditoria e o prazo de resposta associado.
* Audit Locations — os locais auditados, organizados de forma hierárquica.
* Audit Field Defs — os campos adicionais configurados para cada tipo de auditoria.
* Responsibility Matrices — a matriz de responsabilidades: quem responde e quem aprova por tipo de auditoria, local e fornecedor.