使用Python刷新Spotify访问令牌的完整指南

import base64
import json
import requests
import os # 用于安全地获取环境变量

import base64
import json
import requests
import os

# 从环境变量或直接设置您的Spotify API凭证
# 强烈建议使用环境变量来保护这些敏感信息
CLIENT_ID = os.environ.get("SPOTIPY_CLIENT_ID", "YOUR_CLIENT_ID")
CLIENT_SECRET = os.environ.get("SPOTIPY_CLIENT_SECRET", "YOUR_CLIENT_SECRET")

def refresh_spotify_access_token(current_refresh_token: str) -> dict | None:
    """
    使用提供的刷新令牌刷新Spotify访问令牌。

    Args:
        current_refresh_token: 当前有效的刷新令牌。

    Returns:
        一个字典，包含新的访问令牌、（可能更新的）刷新令牌和过期时间，
        如果刷新操作失败则返回 None。
    """
    token_url = "https://accounts.spotify.com/api/token"

    # 1. 编码客户端ID和客户端密钥用于Basic Authorization
    auth_string = f"{CLIENT_ID}:{CLIENT_SECRET}"
    # 将字符串编码为字节，然后进行base64编码，最后解码回字符串
    encoded_auth_string = base64.b64encode(auth_string.encode("utf-8")).decode("utf-8")

    # 2. 构建请求头部
    headers = {
        "Authorization": f"Basic {encoded_auth_string}",
        "Content-Type": "application/x-www-form-urlencoded",
    }

    # 3. 构建请求体数据
    data = {
        "grant_type": "refresh_token",
        "refresh_token": current_refresh_token,
    }

    try:
        # 4. 发送POST请求
        response = requests.post(token_url, headers=headers, data=data)

        # 5. 检查HTTP响应状态码
        response.raise_for_status() # 如果响应状态码是4xx或5xx，则抛出HTTPError异常

        # 6. 解析JSON响应
        json_response = response.json()

        # 安全地提取新的访问令牌和可能的刷新令牌
        new_access_token = json_response.get('access_token')
        # Spotify API有时会返回新的刷新令牌，有时不会。
        # 如果没有新的刷新令牌，则继续使用旧的刷新令牌。
        new_refresh_token = json_response.get('refresh_token', current_refresh_token) 
        expires_in = json_response.get('expires_in')

        if new_access_token:
            return {
                "access_token": new_access_token,
                "refresh_token": new_refresh_token,
                "expires_in": expires_in
            }
        else:
            print("错误：响应中未找到 'access_token'。")
            print(f"响应内容: {response.text}")
            return None

    except requests.exceptions.HTTPError as http_err:
        print(f"HTTP错误发生: {http_err}")
        print(f"响应状态码: {response.status_code}")
        print(f"响应内容: {response.text}")
        return None
    except requests.exceptions.ConnectionError as conn_err:
        print(f"连接错误发生: {conn_err}")
        return None
    except requests.exceptions.Timeout as timeout_err:
        print(f"请求超时: {timeout_err}")
        return None
    except requests.exceptions.RequestException as req_err:
        print(f"发生未知请求错误: {req_err}")
        return None
    except json.JSONDecodeError:
        print(f"无法解析JSON响应: {response.text}")
        return None

if __name__ == "__main__":
    # 请替换为您的实际刷新令牌
    # 刷新令牌通常在您首次通过授权码流获得访问令牌时一并获得
    my_refresh_token = "BQAHt...YOUR_ACTUAL_REFRESH_TOKEN...eA-24" 

    if CLIENT_ID == "YOUR_CLIENT_ID" or CLIENT_SECRET == "YOUR_CLIENT_SECRET":
        print("请设置您的Spotify CLIENT_ID 和 CLIENT_SECRET。建议通过环境变量设置。")
        print("例如：export SPOTIPY_CLIENT_ID='your_client_id'")
        print("例如：export SPOTIPY_CLIENT_SECRET='your_client_secret'")
    elif my_refresh_token == "BQAHt...YOUR_ACTUAL_REFRESH_TOKEN...eA-24":
        print("请将 'my_refresh_token' 替换为您的实际刷新令牌。")
    else:
        print(f"尝试使用刷新令牌刷新访问令牌...")
        refreshed_data = refresh_spotify_access_token(my_refresh_token)

        if refreshed_data:
            print("\n令牌刷新成功！")
            print(f"新的访问令牌: {refreshed_data['access_token'][:30]}...")
            print(f"新的刷新令牌 (如果更新): {refreshed_data['refresh_token'][:30]}...")
            print(f"过期时间 (秒): {refreshed_data['expires_in']}")

            # 您现在可以使用 refreshed_data['access_token'] 来调用Spotify API
            # 并更新您的存储的刷新令牌 (如果 refreshed_data['refresh_token'] 不同于旧的)
        else:
            print("\n刷新令牌失败。请检查您的凭证和刷新令牌是否有效。")