Instruction file imported from DiegoYegros/aratiri (.cursor/rules/api-http.mdc). Copyright stays with the author.

Aratiri HTTP APIs

Name: api-http
Author: DiegoYegros

Preserve the existing HTTP shape used by this repo.
Authenticated and internal endpoints generally live under /v1/....
Public LNURL and discovery endpoints are intentional exceptions; do not force /v1 onto routes that are already meant to be public.
For authenticated endpoints, prefer the existing @AratiriCtx AratiriContext pattern when the surrounding controller uses it instead of switching to raw Spring Security principal types.
Keep request and response payloads in the domain DTO packages under application/dto.
Use Jakarta validation annotations on request DTOs and controller inputs where the API already validates input.
Preserve Swagger/OpenAPI annotations when changing or adding API surface.
Match the existing response style for the endpoint family (ResponseEntity, 200 OK vs 202 Accepted, etc.) instead of introducing a one-off API pattern.

Canonical examples:

@src/main/java/com/aratiri/payments/PaymentsAPI.java
@src/main/java/com/aratiri/invoices/InvoicesAPI.java
@src/main/java/com/aratiri/accounts/AccountsAPI.java

{ "ocm": "1", "id": "diegoyegros-aratiri-api-http-rule", "kind": "skill", "name": "api-http", "description": "HTTP API conventions for Aratiri controllers and DTOs.", "publisher": "DiegoYegros", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-cursor-rules" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "HTTP API conventions for Aratiri controllers and DTOs." ], "primary": false, "metadata": { "source": { "provider": "github-cursor-rules", "repository": "https://github.com/DiegoYegros/aratiri", "path": ".cursor/rules/api-http.mdc", "ref": "c5ab74aee2a2e56120afdc187e467d5d803f56d1", "url": "https://github.com/DiegoYegros/aratiri/blob/c5ab74aee2a2e56120afdc187e467d5d803f56d1/.cursor/rules/api-http.mdc", "key": "DiegoYegros/aratiri/.cursor/rules/api-http.mdc" }, "applies_to": [ "src/main/java/com/aratiri/**/*API.java", "src/main/java/com/aratiri/**/application/dto/**/*.java" ] }, "instructions": "# Aratiri HTTP APIs\n\n- Preserve the existing HTTP shape used by this repo.\n- Authenticated and internal endpoints generally live under `/v1/...`.\n- Public LNURL and discovery endpoints are intentional exceptions; do not force `/v1` onto routes that are already meant to be public.\n- For authenticated endpoints, prefer the existing `@AratiriCtx AratiriContext` pattern when the surrounding controller uses it instead of switching to raw Spring Security principal types.\n- Keep request and response payloads in the domain DTO packages under `application/dto`.\n- Use Jakarta validation annotations on r", "cost": { "context_tokens": 275 } }

api-http

About

Aratiri HTTP APIs

Use it

Manifest

Reviews