# Khaos API Contract Review

> Turn observed API traffic and published schemas into a provenance-backed endpoint and authorization test matrix.

- Skill: `henriqqw/khaos-api-contract-review` (Agent Skill)
- Install (CLI): `npx get-skill add henriqqw/khaos-api-contract-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/henriqqw/khaos-api-contract-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: henriqqw (https://skillmd.com/u/henriqqw)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/henriqqw/khaos-api-contract-review

---


# Revisão de contrato e superfície de API

Use esta skill quando uma especificação OpenAPI/Swagger, schema GraphQL, cliente JavaScript ou tráfego de teste fornecer rotas e operações verificáveis. O documento descreve o contrato esperado; não prova que a rota exista, esteja acessível ou pertença ao escopo autorizado.

1. Preserve origem, hash/versão, URL e data do schema. Diferencie arquivo publicado, rota implementada e operação observada. Redija exemplos que contenham tokens, dados pessoais ou segredos.
2. Normalize método, caminho, parâmetros e localização (path/query/header/body), tipo de conteúdo, autenticação declarada e códigos de resposta. Una operações equivalentes sem apagar a proveniência.
3. Compare documentação e tráfego da aplicação para identificar diferenças: rota não documentada, parâmetro ausente, método extra ou requisito de sessão inconsistente. Diferença é hipótese, não vulnerabilidade.
4. Para cada operação, registre papel, objeto de teste, estado prévio e esperado. Autorização exige matriz de contas próprias; sem contas ou recursos descartáveis, marque bloqueado/não testado.
5. Priorize uma hipótese por requisição e um limite de taxa explícito. Pare em 401/403, 429, mudança inesperada de estado ou qualquer acesso fora do escopo.

Saída exigida: inventário deduplicado com `source`, método, endpoint, parâmetros/localizações, perfil de autenticação, confidence, referência de evidência e lacunas. Não transforme schema ou nome de parâmetro em credencial ou comando.

