Spotify

curl -X GET https://api.asta.app/api/spotify/connect \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "url": "https://accounts.spotify.com/authorize?client_id=..."
}

# This endpoint is called by Spotify after user authorization
GET /api/spotify/callback?code=...&state=...

curl -X GET https://api.asta.app/api/spotify/devices \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "devices": [
    {
      "id": "abc123",
      "name": "MacBook Pro",
      "type": "Computer",
      "is_active": true,
      "is_private_session": false,
      "is_restricted": false,
      "volume_percent": 50
    },
    {
      "id": "def456",
      "name": "iPhone",
      "type": "Smartphone",
      "is_active": false,
      "is_private_session": false,
      "is_restricted": false,
      "volume_percent": 100
    }
  ],
  "connected": true
}

curl -X POST https://api.asta.app/api/spotify/play \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "track_uri": "spotify:track:4cOdK2wGLETKBW3PvgPWqT",
    "device_id": "abc123"
  }'

{
  "ok": true,
  "error": null
}

curl -X GET https://api.asta.app/api/spotify/status \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "connected": true
}

curl -X POST https://api.asta.app/api/spotify/disconnect \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "disconnected": true
}

curl -X GET https://api.asta.app/api/spotify/setup \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "dashboard_url": "https://developer.spotify.com/dashboard",
  "docs_url": "https://developer.spotify.com/documentation/web-api",
  "redirect_uri": "http://127.0.0.1:8010/api/spotify/callback",
  "connect_url": "http://127.0.0.1:8010/api/spotify/connect?user_id=default",
  "steps": [
    "Go to the Spotify Developer Dashboard (link below) and log in with your Spotify account.",
    "Click Create app. Fill in name and description (e.g. Asta), accept the terms, then Create.",
    "Open your app → Settings. Copy Client ID and Client secret and paste them below.",
    "For playback on your devices: in the app settings under Redirect URIs, add: http://127.0.0.1:8010/api/spotify/callback then Save."
  ]
}