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

Vytvářejte API požadavky na 1.1.1.1

Cloudflare nabízí resolver DNS over HTTPS na adrese:

https://cloudflare-dns.com/dns-query

Koncový bod Cloudflare DNS over HTTPS (DoH) podporuje POST a GET pro formát DNS wireformat a GET pro formát JSON.

Při vytváření požadavků pomocí POST, je DNS dotaz zahrnut jako tělo zprávy HTTP požadavku a typ MIME (application/dns-message) se odesílá v Content-Type hlavičku požadavku. Cloudflare použije tělo zprávy HTTP požadavku přesně tak, jak jej odeslal klient, takže tělo zprávy by nemělo být kódováno.

Při vytváření požadavků pomocí GET, je DNS dotaz zakódován do URL.

Pokud používáte formát JSON, nastavte application/dns-json, a pokud používáte DNS wireformat, použijte application/dns-message.

Viz DNS wireformat a JSON pro příklady s cURL.

Každý DNS dotaz odpovídá přesně jednomu HTTP požadavku. Pokud chcete odesílat více dotazů současně, použijte HTTP/2 nebo HTTP/3, které podporují multiplexování více požadavků přes jedno připojení.

HTTP/2 je minimální doporučená verze HTTP pro použití s DoH. Netýká se to konkrétně služby 1.1.1.1, ale způsobu, jakým DoH funguje podle RFC 8484 ↗.

Příklad požadavku:

curl --http2 --header "accept: application/dns-json" "https://one.one.one.one/dns-query?name=cloudflare.com" --next --http2 --header "accept: application/dns-json" "https://one.one.one.one/dns-query?name=example.com"

Pro odesílání požadavků na toto API není nutná žádná autentizace.

Resolver Cloudflare DNS over HTTPS podporuje TLS 1.2 a TLS 1.3.