DoH JSON API

curl "https://api.resolvedb.io/resolve?name=get.newyork.weather.public.v1.resolvedb.net&type=TXT"

GET https://api.resolvedb.io/resolve

{
  "Status": 0,
  "TC": false,
  "RD": true,
  "RA": true,
  "AD": false,
  "CD": false,
  "Question": [
    { "name": "get.newyork.weather.public.v1.resolvedb.net", "type": 16 }
  ],
  "Answer": [
    {
      "name": "get.newyork.weather.public.v1.resolvedb.net",
      "type": 16,
      "TTL": 300,
      "data": "v=rdb1;s=ok;t=data;ttl=300;ts=...;loc=New York...;tc=-0.3;tf=31.5;cnd=partly_cloudy"
    }
  ]
}

curl "https://api.resolvedb.io/resolve?name=get.newyork.weather.public.v1.resolvedb.net&type=TXT"

{
  "Status": 0,
  "TC": false,
  "RD": true,
  "RA": true,
  "AD": false,
  "CD": false,
  "Question": [{ "name": "get.newyork.weather.public.v1.resolvedb.net", "type": 16 }],
  "Answer": [
    {
      "name": "get.newyork.weather.public.v1.resolvedb.net",
      "type": 16,
      "TTL": 300,
      "data": "v=rdb1;s=ok;t=data;ttl=300;ts=1767186000;loc=New York, New York, United States;tc=-0.3;tf=31.5;cnd=partly_cloudy;wnd=19.0;hum=50"
    }
  ]
}

curl "https://api.resolvedb.io/resolve?name=example.com&type=1"

curl "https://api.resolvedb.io/resolve?name=cloudflare.com&type=A&do=true"

async function queryResolveDB(resource, namespace = 'hooli', version = 'v1') {
  const name = `get.${resource}.${namespace}.${version}.resolvedb.net`;
  const url = `https://api.resolvedb.io/resolve?name=${encodeURIComponent(name)}&type=TXT`;

  const response = await fetch(url);
  const data = await response.json();

  if (data.Status !== 0 || !data.Answer?.length) {
    throw new Error(data.Comment || 'Query failed');
  }

  // Parse UQRP response
  const txt = data.Answer[0].data;
  const match = txt.match(/d=(.+)$/);
  return match ? JSON.parse(match[1]) : txt;
}

// Usage
const config = await queryResolveDB('settings.config');
console.log(config); // { theme: "dark", locale: "en-US" }

import requests
import json
import re

def query_resolvedb(resource, namespace='hooli', version='v1'):
    name = f"get.{resource}.{namespace}.{version}.resolvedb.net"
    url = f"https://api.resolvedb.io/resolve?name={name}&type=TXT"

    response = requests.get(url)
    data = response.json()

    if data['Status'] != 0 or not data.get('Answer'):
        raise Exception(data.get('Comment', 'Query failed'))

    # Parse UQRP response
    txt = data['Answer'][0]['data']
    match = re.search(r'd=(.+)$', txt)
    return json.loads(match.group(1)) if match else txt

# Usage
config = query_resolvedb('settings.config')
print(config)  # {'theme': 'dark', 'locale': 'en-US'}

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"net/url"
	"regexp"
)

type DoHResponse struct {
	Status   int       `json:"Status"`
	Answer   []Answer  `json:"Answer"`
	Comment  string    `json:"Comment,omitempty"`
}

type Answer struct {
	Name string `json:"name"`
	Type int    `json:"type"`
	TTL  int    `json:"TTL"`
	Data string `json:"data"`
}

func queryResolveDB(resource, namespace, version string) (map[string]interface{}, error) {
	name := fmt.Sprintf("get.%s.%s.%s.resolvedb.net", resource, namespace, version)
	reqURL := fmt.Sprintf("https://api.resolvedb.io/resolve?name=%s&type=TXT", url.QueryEscape(name))

	resp, err := http.Get(reqURL)
	if err != nil {
		return nil, err
	}
	defer resp.Body.Close()

	var data DoHResponse
	if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
		return nil, err
	}

	if data.Status != 0 || len(data.Answer) == 0 {
		return nil, fmt.Errorf("query failed: %s", data.Comment)
	}

	// Parse UQRP response
	re := regexp.MustCompile(`d=(.+)$`)
	match := re.FindStringSubmatch(data.Answer[0].Data)
	if match == nil {
		return nil, fmt.Errorf("invalid response format")
	}

	var result map[string]interface{}
	if err := json.Unmarshal([]byte(match[1]), &result); err != nil {
		return nil, err
	}
	return result, nil
}

func main() {
	config, err := queryResolveDB("settings.config", "hooli", "v1")
	if err != nil {
		panic(err)
	}
	fmt.Printf("%+v\n", config)
}

curl "https://api.resolvedb.io/resolve?name=nonexistent.resolvedb.net&type=TXT"

{
  "Status": 3,
  "Comment": "NXDOMAIN",
  "Question": [{ "name": "nonexistent.resolvedb.net", "type": 16 }]
}

Cache-Control: max-age=300

Cache-Control: no-store

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1704067260