Questa API consente di gestire un semplice sistema di eventi, permettendo di creare, recuperare, aggiornare e cancellare eventi.
- Node.js
- Express.js
- Node.js v14+ (https://nodejs.org/)
- npm v6+ (https://www.npmjs.com/)
- Clona il repository:
git clone https://github.com/johnnypax/rest-api-node-express-eventi-yt
- Accedi alla cartella del progetto: se usi il clone il nome della cartella sarà uguale a quello della repository
cd rest-api-node-express-eventi-yt
- Installa le dipendenze:
npm install
Per avviare il server, esegui il seguente comando:
node app.js
Il server sarà attivo su http://127.0.0.1:4000.
GET /events
Risposta:
{
"status": "SUCCESS",
"data": [...]
}
GET /events/:cod
Parametri:
:cod
: codice dell'evento
Risposta:
{
"status": "SUCCESS",
"data": { ... }
}
In caso di errore:
{
"status": "ERROR",
"data": "Oggetto non trovato"
}
POST /events
Body (JSON):
{
"nome": "nome_evento",
"descrizione": "descrizione_evento",
"data": "data_evento",
"location": "luogo_evento",
"partecipanti": numero_partecipanti
}
Risposta:
{
"status": "SUCCESS",
"data": { ... }
}
DELETE /events/:cod
Parametri:
:cod
: codice dell'evento
Risposta:
{
"status": "SUCCESS"
}
In caso di errore:
{
"status": "ERROR",
"data": "Oggetto non trovato"
}
GET /events/:cod/:tipo
Parametri:
:cod
: codice dell'evento:tipo
: tipo di aggiornamento (INC
per incrementare,DEC
per decrementare)
Risposta:
Se l'aggiornamento è riuscito:
{
"status": "SUCCESS"
}
Se il comando è errato o ci sono partecipanti insufficienti:
{
"status": "ERROR",
"data": "Partecipanti assenti" oppure "COMANDO NON RICONOSCIUTO"
}
PATCH /events/:cod
Descrizione: Questo endpoint consente di aggiornare uno o più campi di un evento esistente, identificato dal suo codice.
Parametri:
:cod
: codice dell'evento- Body (JSON): Puoi includere uno o più dei seguenti campi nel corpo della richiesta:
{
"nome": "nuovo_nome_evento",
"descrizione": "nuova_descrizione_evento",
"data": "nuova_data_evento",
"location": "nuova_location_evento",
"partecipanti": nuovo_numero_partecipanti
}
- Incremento e decremento dei partecipanti vengono gestiti tramite gli endpoint
/events/:cod/INC
e/events/:cod/DEC
. - La gestione dei dati è fatta in memoria e quindi non è persistente. Ogni riavvio del server resetta i dati.
- Fai un fork del progetto.
- Crea il tuo branch (
git checkout -b feature/NuovaFeature
). - Commit delle tue modifiche (
git commit -m 'Aggiunta NuovaFeature'
). - Fai push al branch (
git push origin feature/NuovaFeature
). - Apri una pull request.
Questo progetto è rilasciato sotto la licenza MIT.