Ревью контракта REST API

engineering

api-contract-review is a Claude Code skill that audits REST API contracts for HTTP semantics, versioning, backward compatibility, and response consistency. It covers HTTP verb selection with idempotency and safety rules, URL-path versus header versus query-param versioning strategies, DTO versus entity separation, pagination on collections, and correct use of HTTP status codes including 201, 204, 401, 403, 409, and 422. The skill activates when a user asks to "review this API" or "check REST endpoints", during PR review of controller changes, or before releasing API updates. Backend developers and code reviewers use it to catch REST semantic violations, internal entity leaks in responses, and the "200 with error body" anti-pattern before changes reach production.