Skip to content

Documentar 201 en POST y 204 en DELETE de /api/notes - #5

Merged
Overrid3CL merged 3 commits into
mainfrom
cursor/openapi-notes-status-d02e
Oct 2, 2026
Merged

Overrid3CL merged 3 commits into
mainfrom
cursor/openapi-notes-status-d02e

Conversation

@Overrid3CL

@Overrid3CL Overrid3CL commented Oct 2, 2026 •

Copy link
Copy Markdown
Owner

Resumen

La spec de springdoc documentaba POST /api/notes y DELETE /api/notes/{id} como 200, aunque el runtime ya devolvía 201 Created y 204 No Content.

@ResponseStatus en NoteController hace que la spec publique 201 con el body de la nota creada y 204 sin body, sin dejar un 200 sobrante. El snapshot frontend/openapi/openapi.json y el cliente Hey API se regeneraron a partir de ese contrato.

Closes #4

Spec

  • POST /api/notes: 200 OK + NoteResponse → 201 Created + NoteResponse
  • DELETE /api/notes/{id}: 200 OK → 204 No Content (sin body)

Pruebas locales

  • ./gradlew test en verde.
  • pnpm lint, pnpm typecheck y pnpm test en verde.
  • El job Cliente OpenAPI ya pasó en CI.
Open in Web Open in Cursor 

cursoragent and others added 3 commits October 2, 2026 15:21
springdoc infería 200 para ResponseEntity; @ResponseStatus alinea la spec OpenAPI y el cliente Hey API con los códigos reales.

Co-authored-by: Ariel Alvarado <Overrid3CL@users.noreply.github.com>
node:26 ya no incluye corepack, así que la imagen y el CI usan npm install -g. El workflow de frontend y del cliente OpenAPI pasa a Node 26, igual que el Dockerfile.

Co-authored-by: Ariel Alvarado <Overrid3CL@users.noreply.github.com>
…us-d02e

Trae main (Node 26) y el arreglo de pnpm sin corepack mientras el PR #7 no está mergeado.

Co-authored-by: Ariel Alvarado <Overrid3CL@users.noreply.github.com>
@Overrid3CL
Overrid3CL marked this pull request as ready for review October 2, 2026 15:33
@Overrid3CL
Overrid3CL merged commit 52e7a09 into main Oct 2, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

OpenAPI: documentar 201 en POST y 204 en DELETE de /api/notes

2 participants