# SDK：Python 和 TypeScript（即将推出）

> okdata 官方 Python 和 TypeScript SDK 正在准备中。发布之前，可以直接调用 HTTP 接口，或用 openapi.json 生成客户端。

网页版：https://okdata.online/zh/docs/sdk/

官方 Python 和 TypeScript SDK 正在准备：每个接口一个有类型的方法，每次调用自动带幂等键，按每个错误的 `retry` 建议自动重试，翻页迭代器带花费上限。目前还没有发布，所以今天没有可安装的包；发布当天这里会写上安装命令。

## 在那之前

接口就是普通 HTTPS 加一个请求头，任何 HTTP 库都能用。每个[接口页](/zh/apis/)都有可直接复制的 cURL、Python（`requests`）和 TypeScript（`fetch`）示例。所有返回的结构见[请求说明](/zh/docs/requests/)。

```python
import os, requests

r = requests.get(
    "https://api.okdata.online/v1/douyin/trends/list",
    headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"},
    timeout=60,
)
body = r.json()
print(body["code"], body["meta"]["billing"]["amount"])
```

## 生成客户端

[openapi.json](/openapi.json) 是覆盖所有接口、参数和返回结构的完整 OpenAPI 3.1 描述，任何 OpenAPI 生成器都能用它生成你所用语言的有类型客户端。目录一变它就会重新生成。

## 给 AI 智能体

智能体用不着 SDK：接上 [MCP 服务](/zh/mcp/)，或者给它装 [Agent Skills](/zh/skills/)。

更新于 2026-11-12