mirror of
https://github.com/azaion/gps-denied-desktop.git
synced 2026-04-22 22:06:36 +00:00
Sync .cursor from detections
This commit is contained in:
@@ -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
|
||||
Reference in New Issue
Block a user