Python实现Spotify访问令牌刷新机制：一个健壮的教程

import json
import requests  # 导入requests模块用于发送HTTP请求

def refresh_spotify_access_token(refresh_token_value: str) -> str | None:
    """
    使用刷新令牌获取新的Spotify访问令牌。

    Args:
        refresh_token_value: 用户当前的刷新令牌。

    Returns:
        新的访问令牌字符串，如果刷新失败则返回None。
    """

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

    # Spotify令牌刷新端点
    url = "https://accounts.spotify.com/api/token"

    # 设置请求头
    # 注意：Spotify的刷新令牌请求通常不需要在Authorization头中包含Client ID和Client Secret
    # 但在获取初始refresh token时是需要的。
    headers = {
        "Content-Type": "application/x-www-form-urlencoded",
    }

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

        # 检查HTTP响应状态码
        if response.status_code == 200:
            # 请求成功，解析JSON响应
            json_result = response.json()

            # 使用.get()方法安全地获取'access_token'，避免KeyError
            # 注意：刷新令牌的响应通常返回新的access_token，而不是新的refresh_token
            new_access_token = json_result.get('access_token') 

            if new_access_token:
                print("成功获取新的访问令牌！")
                return new_access_token
            else:
                print("错误：响应中未找到 'access_token'。")
                print(f"完整响应: {json_result}")
                return None
        else:
            # 请求失败，打印错误信息
            print(f"错误：HTTP状态码 {response.status_code}")
            print(f"响应内容: {response.text}")
            return None

    except requests.exceptions.RequestException as e:
        print(f"网络请求发生异常: {e}")
        return None
    except json.JSONDecodeError:
        print(f"错误：无法解析响应为JSON。响应内容: {response.text}")
        return None

# 示例用法
if __name__ == "__main__":
    # 替换为您的实际刷新令牌
    your_refresh_token = "YOUR_SAVED_REFRESH_TOKEN" 

    new_token = refresh_spotify_access_token(your_refresh_token)

    if new_token:
        print(f"新的访问令牌是: {new_token}")
        # 在这里您可以使用新的访问令牌进行API调用
    else:
        print("未能刷新访问令牌。")