Favorites API

Manage user's favorite radio stations.

List Favorites

Get all radio stations favorited by the user.

Endpoint: GET /api/v1/favorites Authentication: Required

{
  "success": true,
  "message": "Favorites retrieved successfully",
  "data": [
    { ...RadioResource },
    { ...RadioResource }
  ]
}

Add or remove a station from favorites (toggle status).

Endpoint: POST /api/v1/favorites/toggle Authentication: Required

Parameter	Type	Required	Description
`radio_channel_id`	int	Yes	ID of station to toggle

{
  "success": true,
  "message": "Favorite status updated",
  "data": {
    "is_favorited": true,
    "favorites_count": 125
  }
}

Check if a specific station is in user's favorites.

Endpoint: GET /api/v1/favorites/{channel_id}/check Authentication: Required

{
  "success": true,
  "data": {
    "is_favorited": true
  }
}

Explicitly add a station to favorites.

Endpoint: POST /api/v1/favorites Authentication: Required

Parameter	Type	Required	Description
`radio_channel_id`	int	Yes	ID of station to add

Explicitly remove a station from favorites.

Endpoint: DELETE /api/v1/favorites/{channel_id} Authentication: Required