基于Django对接第三方API认证与RESTful服务的指导需求

一、获取第三方Bearer令牌 #

调用第三方登录接口获取令牌是核心第一步，直接用Python的requests库（Django项目里执行pip install requests即可安装），通用实现逻辑如下：

import requests

def fetch_bearer_token():
    # 替换为第三方实际的登录API地址
    login_endpoint = "https://第三方域名/api/auth/login"
    # 按服务商要求构造参数，不同平台字段可能有差异
    auth_payload = {
        "username": "你的第三方平台账号",
        "password": "你的第三方平台密码",
        "client_id": "服务商提供的客户端ID",  # 部分OAuth2服务商要求
        "grant_type": "password"  # 常见授权类型，按需调整
    }
    
    # 用json参数发送请求，自动设置Content-Type为application/json
    response = requests.post(login_endpoint, json=auth_payload)
    
    if response.status_code == 200:
        # 从响应中提取令牌，字段名可能是token/access_token，以服务商文档为准
        return response.json().get("access_token")
    else:
        # 调试用：打印错误信息排查问题
        print(f"令牌获取失败: {response.status_code} - {response.text}")
        return None

二、使用Bearer令牌调用第三方受保护API #

拿到令牌后，在请求头中携带Authorization: Bearer {你的令牌}即可访问受保护接口：

def call_protected_third_party_api(token):
    # 替换为第三方实际的业务API地址
    api_endpoint = "https://第三方域名/api/resource/data"
    request_headers = {
        "Authorization": f"Bearer {token}",
        "Content-Type": "application/json"  # 按需添加，部分API要求
    }
    
    # 根据需求选择GET/POST/PUT等请求方法
    response = requests.get(api_endpoint, headers=request_headers)
    
    if response.status_code == 200:
        return response.json()
    elif response.status_code == 401:
        # 令牌过期，自动重新获取并重试
        new_token = fetch_bearer_token()
        if new_token:
            request_headers["Authorization"] = f"Bearer {new_token}"
            return requests.get(api_endpoint, headers=request_headers).json()
        else:
            print("令牌过期且重新获取失败")
            return None
    else:
        print(f"API调用失败: {response.status_code} - {response.text}")
        return None

三、学习指引 #

1. 掌握requests库核心：重点吃透请求方法、请求头配置、响应解析、错误处理，这是所有第三方API调用的基础。
2. Django项目封装逻辑：把第三方API调用代码封装成独立服务类（比如放在apps/utils/third_party_service.py），避免视图函数冗余，方便复用维护。
3. Stack Overflow案例参考：搜索关键词「Django call third party API Bearer token」，查看其他开发者的实际场景解决方案，令牌缓存、过期自动刷新等问题都有现成讨论。
4. 优化令牌管理：用Django自带的cache框架缓存令牌（设置比服务商令牌过期时间短10-20分钟的缓存时长），减少重复调用登录接口的次数。
5. 补充OAuth2基础：如果第三方用标准OAuth2流程（比如授权码模式），学习OAuth2核心概念，能更快理解不同服务商的认证逻辑。

内容的提问来源于stack exchange，提问作者Sparsh Goel