Cloudflare 提供语言软件开发工具包 (SDK) 以及 curl 示例,演示如何使用 Cloudflare API。SDK 库允许您以特定语言的语法与 Cloudflare API 交互,并更轻松地与现有应用程序集成。
Cloudflare 目前提供以下 SDK:
没有明确的答案说明应该使用哪一种。相反,请考虑您的使用场景,并确定 cURL 还是 SDK 更适合。
| 使用场景 | cURL | SDK |
|---|---|---|
| 在 CLI 中快速测试 | ✅ | ❌ |
| 在 bash 脚本或 CI 中使用 | ✅ | ❌* |
| 在现有应用程序或框架中使用 | ❌ | ✅ |
| 需要串联输出等更复杂的用法 | ❌ | ✅ |
* 虽然可行,但在 bash 脚本或 CI 环境中使用 SDK 并不直接,需要额外的运行时依赖和设置。
以下示例展示如何查询您有权访问的所有 Cloudflare zone。
curl "https://api.cloudflare.com/client/v4/zones" \
--header "Authorization: Bearer <API_TOKEN>"const client = new Cloudflare({
apiToken: process.env["CLOUDFLARE_API_TOKEN"],
});
const zones = await client.zones.list();
console.log(zones);