INTEGRITY Документация

Ранжирование доменов

Cloudflare регулярно формирует рейтинг доменов на основе DNS-запросов к 1.1.1.1, публичного DNS-резолвера Cloudflare. См. запись в блоге ↗ для подробного разбора. Короче говоря, Cloudflare формирует два типа списков:

Список конечных точек

Топ

Пример: получение текущего упорядоченного списка топ-доменов в рейтинге Cloudflare

curl "https://api.cloudflare.com/client/v4/radar/ranking/top?name=top&limit=5" \
--header "Authorization: Bearer <API_TOKEN>"
{
  "success": true,
  "errors": [],
  "result": {
    "top_0": [
			{
				"rank": 1,
				"domain": "google.com"
			},
			{
				"rank": 2,
				"domain": "googleapis.com"
			},
			{
				"rank": 3,
				"domain": "facebook.com"
			},
			{
				"rank": 4,
				"domain": "gstatic.com"
			},
			{
				"rank": 5,
				"domain": "apple.com"
			}
    ]
  },
	"meta": {
		// ...
	}
}

Дополнительные сведения см. в Получение списка популярных доменов.

Пример: скачивание топ x файл группы рейтинга

Как упоминалось в запись в блоге ↗, Cloudflare предоставляет упорядоченный рейтинг для топ-100 доменов, но для остальных указывает только диапазоны рейтинга: например, топ-200 тысяч, топ-1 миллион и так далее. Они доступны через эндпоинты наборов данных.

В следующем примере мы запросим последние доступные интервалы рейтинга доменов:

curl "https://api.cloudflare.com/client/v4/radar/datasets?limit=10&datasetType=RANKING_BUCKET" \
--header "Authorization: Bearer <API_TOKEN>"
{
  "success": true,
  "errors": [],
  "result": {
		"datasets": [
			{
				"id": 213,
				"title": "Top 1000000 ranking domains",
				"description": "Unordered top 1000000 from 2023-01-02 to 2023-01-09",
				"type": "RANKING_BUCKET",
				"tags": [
					"GLOBAL",
					"top_1000000"
				],
				"meta": {
					"top": 1000000
				},
				"alias": "ranking_top_1000000"
			},
			// ...
		]
	}
}

Если вас интересует конкретный топ (например, топ миллион), обратитесь к meta.top свойство. После того как вы нашли нужный топ, получите его id чтобы получить набор данных с помощью GET dataset download url конечная точка.

После этого можно запросить URL-адрес для скачивания:

curl "https://api.cloudflare.com/client/v4/radar/datasets/download" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
  "datasetId": 213
}'
{
  "success": true,
  "errors": [],
  "result": {
		"dataset": {
			"url": "https://example.com/download"
		}
	}
}

Пример: получение последних топ x группа рейтинга

Эта конечная точка позволяет напрямую запросить последнюю доступную группу top x (при необходимости на заданную дату) Получение потока набора данных конечная точка.

Псевдоним набора данных можно получить из Получение наборов данных конечной точки так же, как в примере выше.

Эта потоковая конечная точка доступна только для наборов данных, сформированных после 2023-01-08.

curl "https://api.cloudflare.com/client/v4/radar/datasets/ranking_top_1000" \
--header "Authorization: Bearer <API_TOKEN>"
domain
1rx.io
2mdn.net
360yield.com
3lift.com
a-msedge.net
a2z.com
...

Следующие шаги

См. Анализ сбоев чтобы получить данные о сбоях, происходящих по всему миру.