Music Library API

📡 API Status

✅ API is running

Base URL: http://win.stylescore.sport-timing.pl/MoodFader/music-library-backend/api/tracks.php

🔌 Endpoints

GET /api/tracks Get all tracks

{
  "success": true,
  "data": [...],
  "count": 8
}

GET /api/tracks/{id} Get single track

{
  "success": true,
  "data": { "id": 1, "name": "Sunrise", ... }
}

POST /api/tracks Create new track

{
  "name": "Sunrise",
  "album": "Dawn EP",
  "bpm": 120,
  "music_key": "Fm",
  "genre": "Ambient",
  "mood": "Calm",
  "brightness": 0.7,
  "saturation": 0.6,
  "shape": "circle",
  "level": "middle",
  "position": 0
}

PUT /api/tracks/{id} Update track

Send any fields you want to update in JSON format

DELETE /api/tracks/{id} Delete track

PATCH /api/tracks/order Reorder playlist

{
  "ids": [3, 1, 2, 5, 4]
}

📊 Track Data Model

Each track includes the following fields:

id (int) - Auto-increment primary key
name (string) - Track title
album (string) - Album name
bpm (int) - Beats per minute
music_key (string) - Musical key (e.g., Fm, Am)
genre (string) - Genre of the track
mood (string) - Mood label
brightness (float) - 0.0 to 1.0
saturation (float) - 0.0 to 1.0
shape (enum) - circle, square, triangle, hex
level (enum) - high, loud, middle, soft, extra, slow
position (int) - Playlist ordering
created_at (timestamp) - Creation timestamp

🧪 Testing

Test the API using:

Postman
Insomnia
cURL
Browser DevTools (for GET requests)

🔒 Features

✅ Full CRUD operations
✅ CORS enabled for frontend integration
✅ JSON responses
✅ Input validation
✅ Error handling
✅ Playlist reordering
✅ Prepared statements (SQL injection protection)

🎵 Music Library API

📡 API Status

🔌 Endpoints

📊 Track Data Model

🧪 Testing

🔒 Features