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.
- 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.
- 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.
- 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.
- 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.
- 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.
1---2name: khaos-api-contract-review3description: Turn observed API traffic and published schemas into a provenance-backed endpoint and authorization test matrix.4metadata:5 source: https://skillmd.com/skills/henriqqw/khaos-api-contract-review6 khaos:7 tool_ids: []8 wordlist_ids: []9 stages:10 - enumeration11 - authentication12 - authorization13 - validation14 source_type: derived15 source:16 repository: https://github.com/uphiago/recon-skills17 revision: 1260244136edc6ae698d76d3d526f503e322778d18 path: recon/api-noauth-hunt/SKILL.md19 license: MIT20 reviewed_by: Khaos maintainers21 review_note: Fluxo reescrito para contratos observados e comparação de autorização; sem enumeração cega ou acesso a dados alheios.22---2324# Revisão de contrato e superfície de API2526Use 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.27281. 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.292. 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.303. 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.314. 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.325. 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.3334Saí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.