📰 API de Noticias

Documentació Completa de Rutas i Mètodes

Benvingut a la Documentació de l'API

Aquesta página documenta totes les rutas i mètodes disponibles en aquest API. Selecciona el mètode HTTP a la columna esquerra per veure els detalls de cada endpoint. Els endpoints marcats com a "Protegits" requereixen autenticació.

23
Rutas Totals
6
Grups de Recursos
14
Rutas Públiques
9
Rutas Protegides

🔐 Autenticació

POST /api/auth/register
Registra un nou usuari en el sistema
Pública
POST /api/auth/login
Inicia sessió amb les credencials de l'usuari
Pública
GET /api/auth/profile
Obté el perfil de l'usuari actual
Protegida - Autenticació requerida

👥 Usuaris

GET /api/users
Obté la llista de tots els usuaris
Protegida - Admin requerit
GET /api/users/:id
Obté els detalls d'un usuari específic
Protegida - Admin requerit

🏷️ Categories

GET /api/categories
Obté totes les categories ordenades per nom
Pública
GET /api/categories/:id
Obté els detalls d'una categoria específica
Pública
POST /api/categories
Crea una nova categoria
Protegida - Admin requerit
PUT /api/categories/:id
Actualitza una categoria existent
Protegida - Admin requerit
DELETE /api/categories/:id
Elimina una categoria
Protegida - Admin requerit

📰 Noticias

GET /api/news
Obté totes les notícies amb filtratge opcional per categoria i estat de publicació
Pública
GET /api/news/:id
Obté els detalls d'una notícia específica
Pública
POST /api/news
Crea una nova notícia
Protegida - Editor requerit
PUT /api/news/:id
Actualitza una notícia existent
Protegida - Editor requerit
DELETE /api/news/:id
Elimina una notícia
Protegida - Editor requerit
PATCH /api/news/:id/publish
Commuta l'estat de publicació d'una notícia
Protegida - Editor requerit

🖼️ Imatges

GET /api/images/news/:id_new
Obté totes les imatges associades a una notícia
Pública
GET /api/images/:id
Obté els detalls d'una imatge específica
Pública
POST /api/images/upload
Puja una nova imatge per a una notícia
Protegida - Editor requerit
DELETE /api/images/:id
Elimina una imatge
Protegida - Editor requerit
PATCH /api/images/:id/order
Actualitza l'ordre de les imatges
Protegida - Editor requerit

📧 Contacte

POST /api/contact
Envia un missatge de contacte (sense autenticació requerida)
Pública
GET /api/contact
Obté tots els missatges de contacte
Protegida - Editor requerit
GET /api/contact/:id
Obté els detalls d'un missatge de contacte específic
Protegida - Editor requerit
DELETE /api/contact/:id
Elimina un missatge de contacte
Protegida - Editor requerit