← Cloudflare Fundamentals / fundamentals / api / reference

SDK

Cloudflare предлагает пакеты SDK для разных языков программирования, а также curl примеры, демонстрирующие использование Cloudflare API. Библиотеки SDK позволяют работать с Cloudflare API на синтаксисе конкретного языка программирования и упрощают интеграцию с вашими существующими приложениями.

В настоящее время Cloudflare предлагает следующие SDK:

Когда использовать cURL, а когда SDK

Однозначного ответа, что использовать, нет. Оцените свой сценарий использования и определите, что подходит лучше: cURL или SDK.

Сценарий использования	cURL	SDK
Быстрое тестирование в CLI	✅	❌
Используйте в bash-скриптах или CI	✅	❌*
Использование в рамках существующего приложения или фреймворка	❌	✅
Более сложные сценарии использования, где необходимо связывать выходные данные в цепочку	❌	✅

* SDK можно использовать в bash-скриптах или средах CI при дополнительных зависимостях времени выполнения и настройке, хотя это не так просто.

Пример

Ниже приведены примеры запроса всех зон Cloudflare, к которым у вас есть доступ.

С cURL:

curl "https://api.cloudflare.com/client/v4/zones" \
--header "Authorization: Bearer <API_TOKEN>"

С TypeScript SDK:

const client = new Cloudflare({
	apiToken: process.env["CLOUDFLARE_API_TOKEN"],
});

const zones = await client.zones.list();

console.log(zones);