DNS resolve

GET

/resolve

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://api.dazrik.net/resolve?target=example.com&record=MX"

  req, _ := http.NewRequest("GET", url, nil)

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.dazrik.net/resolve?target=example.com&record=MX"))
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.dazrik.net/resolve?target=example.com&record=MX")
  .get()
  .build();

Response response = client.newCall(request).execute();

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.dazrik.net/resolve',
  params: {target: 'example.com', record: 'MX'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://api.dazrik.net/resolve?target=example.com&record=MX';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

use reqwest;

#[tokio::main]
pub async fn main() {
    let url = "https://api.dazrik.net/resolve";

    let querystring = [
        ("target", "example.com"),
        ("record", "MX"),
    ];

    let client = reqwest::Client::new();
    let response = client.get(url)
        .query(&querystring)
        .send()
        .await;

    let results = response.unwrap()
        .json::<serde_json::Value>()
        .await
        .unwrap();

    dbg!(results);
}

Without a record param, resolves the hostname to all of its A/AAAA addresses split by family. With a record param, returns that record type’s values.

Parameters

Query Parameters

target

required

string

Hostname to target. Raw IP addresses are rejected.

Example

example.com

record

string

Allowed values: A AAAA SRV MX CNAME NS SOA TXT

DNS record type to look up (case-insensitive). Omit to return A/AAAA addresses split by family.

Example

MX

Responses

200

Either the address split (no record) or the requested record’s structured values.

application/json

One of:

object
object

Address resolution result, returned when no record param is supplied.

object

required

boolean

query

required

string

addresses

required

object

required

Array<string>

required

Array<string>

DNS record lookup result, returned when a record param is supplied. The shape of result depends on the record type.

object

required

boolean

query

required

string

record

required

string

Allowed values: A AAAA SRV MX CNAME NS SOA TXT

result

required

One of:

A, AAAA, NS, CNAME, TXT

Array<string>

Examples

No record param addresses split by family

{
  "ok": true,
  "query": "example.com",
  "addresses": {
    "v4": [
      "93.184.216.34"
    ],
    "v6": [
      "2606:2800:220:1:248:1893:25c8:1946"
    ]
  }
}

record=MX one object per mail server

{
  "ok": true,
  "query": "example.com",
  "record": "MX",
  "result": [
    {
      "priority": 10,
      "exchange": "mail.example.com"
    },
    {
      "priority": 20,
      "exchange": "mail2.example.com"
    }
  ]
}

record=SOA single object (null when absent)

{
  "ok": true,
  "query": "example.com",
  "record": "SOA",
  "result": {
    "nsname": "ns.example.com",
    "hostmaster": "hostmaster.example.com",
    "serial": 2024010101,
    "refresh": 7200,
    "retry": 3600,
    "expire": 1209600,
    "minttl": 3600
  }
}

Headers

RateLimit

string

IETF-draft combined rate-limit header for the current window: limit, remaining, and reset (seconds until the window resets). Sent on every response from a known endpoint.

Example

limit=60, remaining=59, reset=42

RateLimit-Limit

integer

Maximum requests allowed per client IP per window (60 requests per 60s).

Example

RateLimit-Remaining

integer

Requests remaining in the current window before the limit is hit.

Example

RateLimit-Reset

integer

Seconds until the current window resets.

Example

400

Missing or invalid parameter

application/json

Error response.

object

required

boolean

msg

required

string

Example

{
  "ok": false,
  "msg": "query param target is required"
}

Headers

RateLimit

string

IETF-draft combined rate-limit header for the current window: limit, remaining, and reset (seconds until the window resets). Sent on every response from a known endpoint.

Example

limit=60, remaining=59, reset=42

RateLimit-Limit

integer

Maximum requests allowed per client IP per window (60 requests per 60s).

Example

RateLimit-Remaining

integer

Requests remaining in the current window before the limit is hit.

Example

RateLimit-Reset

integer

Seconds until the current window resets.

Example

403

Target resolves to a private/reserved address

application/json

Error response.

object

required

boolean

msg

required

string

Example

{
  "ok": false,
  "msg": "target doesn't resolve to a public addr"
}

Headers

RateLimit

string

IETF-draft combined rate-limit header for the current window: limit, remaining, and reset (seconds until the window resets). Sent on every response from a known endpoint.

Example

limit=60, remaining=59, reset=42

RateLimit-Limit

integer

Maximum requests allowed per client IP per window (60 requests per 60s).

Example

RateLimit-Remaining

integer

Requests remaining in the current window before the limit is hit.

Example

RateLimit-Reset

integer

Seconds until the current window resets.

Example

429

Rate limit exceeded: either the per-client request limit (60 requests per minute) or, for endpoints that connect to the target, the per-destination outbound connection limit.

application/json

Error response.

object

required

boolean

msg

required

string

Example

{
  "ok": false,
  "msg": "you're being rate limited, try again later."
}

Headers

RateLimit

string

IETF-draft combined rate-limit header for the current window: limit, remaining, and reset (seconds until the window resets). Sent on every response from a known endpoint.

Example

limit=60, remaining=59, reset=42

RateLimit-Limit

integer

Maximum requests allowed per client IP per window (60 requests per 60s).

Example

RateLimit-Remaining

integer

Requests remaining in the current window before the limit is hit.

Example

RateLimit-Reset

integer

Seconds until the current window resets.

Example

Retry-After

integer

Seconds to wait before retrying. Sent only on a 429 response.

Example

500

Unexpected server error

application/json

Error response.

object

required

boolean

msg

required

string

Example

{
  "ok": false,
  "msg": "unknown error"
}

Headers

RateLimit

string

IETF-draft combined rate-limit header for the current window: limit, remaining, and reset (seconds until the window resets). Sent on every response from a known endpoint.

Example

limit=60, remaining=59, reset=42

RateLimit-Limit

integer

Maximum requests allowed per client IP per window (60 requests per 60s).

Example

RateLimit-Remaining

integer

Requests remaining in the current window before the limit is hit.

Example

RateLimit-Reset

integer

Seconds until the current window resets.