如何用Python从Streamlabs API实时获取最新捐赠信息？授权错误排查

问题排查要点 #

以下是导致未授权错误的常见原因及验证方式：

• Scope参数一致性：确认Streamlabs开发者后台配置的授权scope与代码中的scope = "donations.read"完全一致（注意是复数donations，而非单数donation）。
• 重定向URI完全匹配：代码中的redirect_uri必须和开发者控制台中填写的回调地址完全一致，包括协议（http/https）、域名、端口和路径，多一个斜杠或大小写差异都会触发授权失败。
• 授权码有效性：授权码仅能使用一次，且有效期约10分钟，重复使用或超时会直接返回未授权错误，需重新生成授权码。
• Access Token状态：获取Token时检查expires_in字段确认是否过期，过期需重新刷新或重新获取。
• 请求头格式：确保Authorization头严格遵循Bearer {access_token}格式，Bearer与Token之间必须有一个空格。

实时获取捐赠的正确实现方式 #

Streamlabs实时捐赠需通过WebSocket连接接收事件，而非单次HTTP请求。以下是修正后的完整代码：

import requests
import websocket
import json

# 替换为你的实际配置参数
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
redirect_uri = "YOUR_REDIRECT_URI"
scope = "donations.read"
state = "123456"

# 1. 生成授权链接并获取授权码
auth_url = f"https://streamlabs.com/api/v2.0/authorize?client_id={client_id}&redirect_uri={redirect_uri}&scope={scope}&response_type=code&state={state}"
print(f"打开以下链接获取授权码: {auth_url}")
auth_code = input("输入授权码: ")

# 2. 用授权码交换Access Token
token_url = "https://streamlabs.com/api/v2.0/token"
headers = {"Content-Type": "application/x-www-form-urlencoded"}
data = {
    "grant_type": "authorization_code",
    "client_id": client_id,
    "client_secret": client_secret,
    "redirect_uri": redirect_uri,
    "code": auth_code
}

response = requests.post(token_url, headers=headers, data=data)
if response.status_code != 200:
    print(f"获取Access Token失败: {response.status_code} - {response.json()['message']}")
    exit()

access_token = response.json()["access_token"]
print(f"Access Token获取成功: {access_token}")

# 3. 获取Socket Token
socket_url = "https://streamlabs.com/api/v2.0/socket/token"
headers = {"Authorization": f"Bearer {access_token}", "Accept": "application/json"}
response = requests.get(socket_url, headers=headers)

if response.status_code != 200:
    print(f"获取Socket Token失败: {response.status_code} - {response.json()['message']}")
    exit()

socket_token = response.json()["socket_token"]
print(f"Socket Token获取成功: {socket_token}")

# 4. 建立WebSocket连接监听实时捐赠事件
def on_message(ws, message):
    data = json.loads(message)
    # 过滤并处理捐赠事件
    if data.get("event") == "donation":
        print("\n收到新捐赠:")
        donation_info = data['message'][0]
        print(f"捐赠者: {donation_info['name']}")
        print(f"金额: {donation_info['amount']} {donation_info['currency']}")
        print(f"留言: {donation_info.get('message', '无')}")

def on_error(ws, error):
    print(f"WebSocket错误: {error}")

def on_close(ws):
    print("WebSocket连接关闭")

def on_open(ws):
    print("WebSocket连接已建立，开始监听捐赠...")

if __name__ == "__main__":
    ws_url = f"wss://sockets.streamlabs.com/socket.io/?token={socket_token}&EIO=3&transport=websocket"
    ws = websocket.WebSocketApp(ws_url,
                                on_message=on_message,
                                on_error=on_error,
                                on_close=on_close)
    ws.on_open = on_open
    ws.run_forever()

额外注意事项 #

• 需先安装依赖库：pip install websocket-client
• 确保你的Streamlabs账户已绑定捐赠平台（如Twitch、YouTube等），否则无法收到捐赠事件
• 若WebSocket连接失败，优先检查Socket Token是否过期，Access Token过期会导致Socket Token失效

内容的提问来源于stack exchange，提问作者Shamna Sama