Skip to content

Mik318/task-hex-arq

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Documentación de Endpoints - TaskService

Endpoints

Crear una tarea

URL: /tasks
Método: POST
Descripción: Crea una nueva tarea.
Cuerpo de la solicitud:

{
  "title": "Título de la tarea",
  "description": "Descripción de la tarea"
}

Respuesta exitosa:
Código: 201 Created

{
  "id": 1,
  "title": "Título de la tarea",
  "description": "Descripción de la tarea"
}

Obtener una tarea por ID

URL: /tasks/{id}
Método: GET
Descripción: Obtiene los detalles de una tarea específica.
Parámetros de ruta:

  • id: ID de la tarea.

Respuesta exitosa:
Código: 200 OK

{
  "id": 1,
  "title": "Título de la tarea",
  "description": "Descripción de la tarea"
}

Actualizar una tarea

URL: /tasks/{id}
Método: PUT
Descripción: Actualiza los detalles de una tarea existente.
Parámetros de ruta:

  • id: ID de la tarea.

Cuerpo de la solicitud:

{
  "title": "Nuevo título",
  "description": "Nueva descripción"
}

Respuesta exitosa:
Código: 200 OK

{
  "id": 1,
  "title": "Nuevo título",
  "description": "Nueva descripción"
}

Eliminar una tarea

URL: /tasks/{id}
Método: DELETE
Descripción: Elimina una tarea específica.
Parámetros de ruta:

  • id: ID de la tarea.

Respuesta exitosa:
Código: 204 No Content


Obtener todas las tareas

URL: /tasks
Método: GET
Descripción: Obtiene una lista de todas las tareas.

Respuesta exitosa:
Código: 200 OK

[
  {
    "id": 1,
    "title": "Título de la tarea",
    "description": "Descripción de la tarea"
  },
  {
    "id": 2,
    "title": "Otra tarea",
    "description": "Otra descripción"
  }
]

Obtener información adicional de una tarea

URL: /tasks/{id}/additional-info
Método: GET
Descripción: Obtiene información adicional de una tarea específica.
Parámetros de ruta:

  • id: ID de la tarea.

Respuesta exitosa:
Código: 200 OK

{
  "id": 1,
  "additionalInfo": "Información adicional de la tarea"
}

Notas

  • Todos los endpoints devuelven errores con códigos estándar como 400 Bad Request, 404 Not Found, etc., en caso de fallos.
  • Asegúrate de enviar los datos en formato JSON cuando sea necesario.

About

API RESTful para tareas con arquitectura hexagonal. Ofrece operaciones CRUD completas y consulta de información adicional sobre tareas. Implementado con Spring Boot, organizado en capas (dominio, aplicación, infraestructura) y siguiendo principios SOLID. Tecnologías: Java, Spring Boot, JPA, Maven, MySQL.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages