News Paper API

Autor: David Crespo

Todas las rutas protegidas requieren el header auth-token con un JWT válido obtenido en /api/login.

Autenticación

MétodoEndpointDescripciónAutorización
POST/api/registerRegistrar nuevo usuarioNo
POST/api/loginIniciar sesión, devuelve token JWTNo
POST/api/logoutCerrar sesión (invalida el token actual)Sí
GET/api/meDatos del usuario autenticadoSí

Área personal

MétodoEndpointDescripciónAutorización
GET/api/areapersonalDatos del usuario (nombre, avatar)Sí
PUT/api/areapersonalModificar nombre/contraseñaSí
PUT/api/areapersonal/avatarSubir/actualizar avatarSí

Artículos

MétodoEndpointDescripciónAutorización
GET/api/articlesListado de artículosNo
GET/api/articles/:idObtener artículo por IDNo
GET/api/articles/:id/commentsComentarios de un artículoNo
POST/api/articlesCrear artículoSí
POST/api/articles/:id/voteVotar artículo (upVote/downVote)Sí
PUT/api/articles/:idEditar artículoSí
DELETE/api/articles/:idEliminar (soft delete) artículoSí
GET/api/:category/articlesArtículos filtrados por categoríaNo

Comentarios

MétodoEndpointDescripciónAutorización
GET/api/commentsListado de comentariosNo
GET/api/comments/:idObtener comentario por IDNo
POST/api/commentsCrear comentarioSí
POST/api/comments/:id/voteVotar comentario (upVote/downVote)Sí
PUT/api/comments/:idEditar comentarioSí
DELETE/api/comments/:idEliminar (soft delete) comentarioSí

Categorías

MétodoEndpointDescripciónAutorización
GET/api/categoriesListado de categoríasNo
POST/api/categoriesCrear categoríaSí
PUT/api/categories/:idEditar categoríaSí
DELETE/api/categories/:idEliminar categoríaSí