> ## Documentation Index > Fetch the complete documentation index at: https://docs.verifica.ia.br/llms.txt > Use this file to discover all available pages before exploring further. # Iniciar Análise de Risco > Inicia uma análise de risco para um contrato específico. A análise é processada de forma assíncrona e pode levar alguns minutos para ser concluída. Use o endpoint GET para verificar o status e obter os resultados da análise. ## OpenAPI ````yaml api-reference/openapi.yaml post /risk-analysis/contracts/{contractId}/analyze openapi: 3.1.0 info: title: Verifica AI API description: > API para análise de contratos com inteligência artificial. ## Autenticação A API Verifica AI oferece autenticação via JWT (JSON Web Token) para acesso programático aos endpoints da API. ### Como obter o token: Faça login através do endpoint `/auth/login` com suas credenciais: ```bash curl -X POST https://api.verifica.ia.br/auth/login \ -H "Content-Type: application/json" \ -d '{ "email": "usuario@example.com", "password": "senha123456" }' ``` ### Header de autenticação: ``` Authorization: Bearer SEU_TOKEN_JWT ``` Para mais informações, consulte a [documentação completa de autenticação](/essentials/authentication). version: 1.0.0 contact: name: Verifica AI Support email: support@verifica.ia.br license: name: Proprietary servers: - url: https://api.verifica.ia.br description: Produção - url: http://localhost:3333 description: Desenvolvimento security: [] tags: - name: Health description: Endpoints de verificação de saúde da API - name: Authentication description: Autenticação JWT para acesso programático à API - name: Contracts description: Gestão de contratos - name: Risk Analysis description: Análise de risco de contratos - name: API Keys description: Gestão de API Keys paths: /risk-analysis/contracts/{contractId}/analyze: post: tags: - Risk Analysis summary: Iniciar Análise de Risco description: > Inicia uma análise de risco para um contrato específico. A análise é processada de forma assíncrona e pode levar alguns minutos para ser concluída. Use o endpoint GET para verificar o status e obter os resultados da análise. operationId: analyzeContract parameters: - name: contractId in: path required: true schema: type: string format: uuid description: ID do contrato a ser analisado responses: '200': description: Análise iniciada com sucesso content: application/json: schema: $ref: '#/components/schemas/ContractAnalysis' example: _id: analysis-uuid contractId: contract-uuid userId: user-uuid status: in_progress overallRisk: MEDIUM riskScore: 0 summary: '' sections: [] criticalIssues: [] recommendations: [] analyzedAt: $date: '2025-01-12T16:58:20.130Z' modelVersion: 1.0.0 createdAt: $date: '2025-01-12T16:58:20.130Z' updatedAt: $date: '2025-01-12T16:58:20.130Z' __v: 0 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': description: Limite de análises atingido ou plano bloqueado content: application/json: schema: $ref: '#/components/schemas/Error' example: message: Plan limit reached errors: - You have reached your analysis limit for this plan '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' security: - BearerAuth: [] components: schemas: ContractAnalysis: type: object properties: _id: type: string description: ID único da análise contractId: type: string format: uuid description: ID do contrato analisado userId: type: string format: uuid description: ID do usuário proprietário overallRisk: $ref: '#/components/schemas/RiskLevel' riskScore: type: integer minimum: 0 maximum: 100 description: Score geral de risco (0-100) summary: type: string description: Resumo da análise sections: type: array items: $ref: '#/components/schemas/Section' criticalIssues: type: array items: $ref: '#/components/schemas/CriticalIssue' recommendations: type: array items: $ref: '#/components/schemas/Recommendation' status: $ref: '#/components/schemas/AnalysisStatus' analyzedAt: type: object properties: $date: type: string format: date-time description: Data e hora da análise modelVersion: type: string description: Versão do modelo de IA utilizado learningContext: type: string description: Contexto de aprendizado (opcional) createdAt: type: object properties: $date: type: string format: date-time description: Data de criação updatedAt: type: object properties: $date: type: string format: date-time description: Data de atualização __v: type: integer description: Versão do documento (MongoDB) Error: type: object properties: message: type: string description: Mensagem de erro errors: type: array items: type: object description: Lista de erros de validação (opcional) RiskLevel: type: string enum: - LOW - MEDIUM - HIGH description: Nível de risco Section: type: object properties: sectionId: type: string description: ID da seção sectionTitle: type: string description: Título da seção riskLevel: $ref: '#/components/schemas/RiskLevel' riskScore: type: integer minimum: 0 maximum: 100 description: Score de risco da seção (0-100) issues: type: array items: $ref: '#/components/schemas/Issue' clauses: type: array items: $ref: '#/components/schemas/Clause' CriticalIssue: type: object properties: issue: $ref: '#/components/schemas/Issue' impact: type: string description: Impacto do problema crítico urgency: $ref: '#/components/schemas/RecommendationPriority' Recommendation: type: object properties: priority: $ref: '#/components/schemas/RecommendationPriority' category: $ref: '#/components/schemas/RecommendationCategory' description: type: string description: Descrição da recomendação actionItems: type: array items: type: string description: Lista de ações recomendadas AnalysisStatus: type: string enum: - pending - in_progress - completed - failed description: Status da análise Issue: type: object properties: type: $ref: '#/components/schemas/IssueType' severity: $ref: '#/components/schemas/IssueSeverity' description: type: string description: Descrição do problema clauseReference: type: string description: Referência à cláusula (opcional) recommendation: type: string description: Recomendação relacionada (opcional) Clause: type: object properties: clauseId: type: string description: ID da cláusula clauseTitle: type: string description: Título da cláusula riskLevel: $ref: '#/components/schemas/RiskLevel' riskScore: type: integer minimum: 0 maximum: 100 description: Score de risco da cláusula (0-100) issues: type: array items: $ref: '#/components/schemas/Issue' explanation: type: string description: Explicação sobre o risco da cláusula RecommendationPriority: type: string enum: - LOW - MEDIUM - HIGH - IMMEDIATE description: Prioridade da recomendação RecommendationCategory: type: string enum: - Legal - Financeiro - Operacional - Compliance description: Categoria da recomendação IssueType: type: string enum: - LEGAL - FINANCIAL - OPERATIONAL - COMPLIANCE description: Tipo de problema identificado IssueSeverity: type: string enum: - LOW - MEDIUM - HIGH description: Severidade do problema responses: BadRequest: description: Requisição inválida content: application/json: schema: $ref: '#/components/schemas/Error' example: message: File is required errors: [] Unauthorized: description: Não autorizado - Token inválido ou ausente content: application/json: schema: $ref: '#/components/schemas/Error' examples: missingToken: value: message: Authorization header is required expiredToken: value: message: Token expired NotFound: description: Recurso não encontrado content: application/json: schema: $ref: '#/components/schemas/Error' example: message: Contract not found InternalServerError: description: Erro interno do servidor content: application/json: schema: $ref: '#/components/schemas/Error' example: message: Internal server error securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: | Token JWT obtido através do endpoint `/auth/login`. Inclua o token no header: `Authorization: Bearer SEU_TOKEN_JWT` ````