Log Explorer API

Настройка и поиск по журналам также доступны через публичный API.

Аутентификация

Аутентификация в API выполняется с помощью API-токена или API-ключа и адреса электронной почты. См. Создание API-токена для получения дальнейших инструкций.

Подробную информацию о разрешениях, необходимых для каждой функции Log Explorer, см. в Разрешения раздел.

Запрос данных

Log Explorer включает SQL API для отправки запросов.

Например, чтобы найти HTTP-запрос с определённым Ray ID, используйте следующий SQL-запрос:

curl https://api.cloudflare.com/client/v4/zones/{zone_id}/logs/explorer/query/sql \
--header "Authorization: Bearer <API_TOKEN>" \
--url-query query="SELECT clientRequestScheme, clientRequestHost, clientRequestMethod, edgeResponseStatus, clientRequestUserAgent FROM http_requests WHERE RayID = '806c30a3cec56817' LIMIT 1"

Эта команда возвращает следующие сведения об HTTP-запросе:

{
	"result": [
		{
			"clientrequestscheme": "https",
			"clientrequesthost": "example.com",
			"clientrequestmethod": "GET",
			"clientrequestuseragent": "curl/7.88.1",
			"edgeresponsestatus": 200
		}
	],
	"success": true,
	"errors": [],
	"messages": []
}

В качестве ещё одного примера вы можете найти запросы Cloudflare Access с нужными столбцами за определённый период, выполнив следующий SQL-запрос:

curl https://api.cloudflare.com/client/v4/accounts/{account_id}/logs/explorer/query/sql \
--header "Authorization: Bearer <API_TOKEN>" \
--url-query query="SELECT CreatedAt, AppDomain, AppUUID, Action, Allowed, Country, RayID, Email, IPAddress, UserUID FROM access_requests WHERE Date >= '2025-02-06' AND Date <= '2025-02-06' AND CreatedAt >= '2025-02-06T12:28:39Z' AND CreatedAt <= '2025-02-06T12:58:39Z'"

Эта команда возвращает следующие сведения о запросе:

{
	"result": [
		{
			"createdat": "2025-01-14T18:17:55Z",
			"appdomain": "example.com",
			"appuuid": "a66b4ab0-ccdf-4d60-a6d0-54a59a827d92",
			"action": "login",
			"allowed": true,
			"country": "us",
			"rayid": "90fbb07c0b316957",
			"email": "[email protected]",
			"ipaddress": "1.2.3.4",
			"useruid": "52859e81-711e-4de0-8b31-283336060e79"
		}
	],
	"success": true,
	"errors": [],
	"messages": []
}