← 1.1.1.1 (DNS-резолвер) / 1.1.1.1 / encryption / dns-over-https / make-api-requests

Использование JSON

Конечная точка Cloudflare DNS через HTTPS также поддерживает формат JSON для запросов DNS-данных. Поскольку в Internet Engineering Task Force (IETF) нет согласованной JSON-схемы для DNS через HTTPS, Cloudflare решила использовать ту же схему, что и резолвер DNS через HTTPS от Google.

Запросы в формате JSON отправляются с помощью GET-запрос. При отправке запросов с помощью GET, DNS-запрос кодируется в URL. Добавьте заголовок HTTP Accept заголовок запроса с MIME-типом application/dns-json, указывая, что клиент может принять ответ в формате JSON.

Пример запроса и ответа:

curl --header "accept: application/dns-json" "https://cloudflare-dns.com/dns-query?name=example.com&type=AAAA"

{
	"Status": 0,
	"TC": false,
	"RD": true,
	"RA": true,
	"AD": true,
	"CD": false,
	"Question": [
		{
			"name": "example.com.",
			"type": 28
		}
	],
	"Answer": [
		{
			"name": "example.com.",
			"type": 28,
			"TTL": 1726,
			"data": "2606:2800:220:1:248:1893:25c8:1946"
		}
	]
}

В случае недействительного запроса возвращается 400 Bad Request возвращается ошибка:

curl --header "accept: application/dns-json" "https://cloudflare-dns.com/dns-query?name=example.com&cd=2"

{
	"error": "Invalid CD flag `2`. Expected to be empty or one of `0`, `false`, `1`, or `true`."
}

В приведённых ниже таблицах можно найти подробности о каждом поле ответа.