快速上手

此示例演示如何在使用 Bearer Token 进行身份验证的情况下，通过 XDK 快速搜索 Post。

​

步骤 1：安装 SDK

pip install xdk

​

步骤 2：获取 Bearer Token

1. 登录 X 开发者门户。
2. 创建或选择一个 App。
3. 在“Keys and Tokens”下生成 Bearer Token（仅限应用的身份验证，app-only auth）。

​

步骤 3：编写并运行你的第一个脚本

创建一个名为 quickstart.py 的文件：

# 导入客户端
from xdk import Client

# 替换为您实际的 Bearer Token
client = Client(bearer_token="YOUR_BEARER_TOKEN_HERE")

# 获取最近提及"api"的 Post
response = client.posts.search_recent(query="api", max_results=10)

# 打印第一条 Post 的文本
if response.data:
    print(f"最新 Post: {response.data[0]['text']}")
else:
    print("未找到 Post。")

运行：

python quickstart.py

预期输出：

最新帖子：XDK Python SDK 重要更新！

故障排查：如果遇到 401 错误，请再次核对你的 Bearer Token。对于速率限制（429），请稍等片刻后重试。

​

后续步骤

• 查看身份验证，了解如何使用 Bearer Token（仅限 App）认证、带 PKCE 的 OAuth 2.0（用户上下文）以及 OAuth 1.0。
• 了解分页，适用于在无需进行多次 API 调用的情况下返回大量结果的场景。
• 深入了解流式传输，学习如何处理实时 data。