← 1.1.1.1 (DNS resolver) / 1.1.1.1 / encryption / dns-over-https / make-api-requests

Použití JSON

Koncový bod Cloudflare DNS over HTTPS podporuje také formát JSON pro dotazování na údaje DNS. V rámci Internet Engineering Task Force (IETF) neexistuje pro DNS over HTTPS žádné jednotné schéma JSON, proto se Cloudflare rozhodl řídit se stejným schématem jako resolver DNS over HTTPS společnosti Google.

Dotazy ve formátu JSON se odesílají pomocí GET požadavek. Při vytváření požadavků pomocí GET, je DNS dotaz zakódován do URL. Přidejte hlavičku HTTP Accept v hlavičce požadavku s typem MIME application/dns-json aby bylo zřejmé, že klient dokáže přijmout odpověď ve formátu JSON.

Příklad požadavku a odpovědi:

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"
		}
	]
}

V případě neplatného požadavku se vrátí 400 Bad Request se vrátí chyba:

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`."
}

Následující tabulky obsahují další informace o jednotlivých polích odpovědi.