Sync .cursor from detections

This commit is contained in:
Oleksandr Bezdieniezhnykh
2026-04-12 05:05:10 +03:00
parent bc69fd4b0a
commit 33a3c80cf5
67 changed files with 2555 additions and 1871 deletions
+15
View File
@@ -0,0 +1,15 @@
---
description: "OpenAPI/Swagger API documentation standards — applied when editing API spec files"
globs: ["**/openapi*", "**/swagger*"]
alwaysApply: false
---
# OpenAPI
- Use OpenAPI 3.0+ specification
- Define reusable schemas in `components/schemas`; reference with `$ref`
- Include `description` for every endpoint, parameter, and schema property
- Define `responses` for at least 200, 400, 401, 404, 500
- Use `tags` to group endpoints by domain
- Include `examples` for request/response bodies
- Version the API in the path (`/api/v1/`) or via header
- Use `operationId` for code generation compatibility