Probe an http(s) target

GET

/website

package main

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

func main() {

  url := "https://api.dazrik.net/website?target=example.com"

  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/website?target=example.com"))
    .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/website?target=example.com")
  .get()
  .build();

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

import axios from 'axios';

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

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

const url = 'https://api.dazrik.net/website?target=example.com';
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/website";

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

    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);
}

Sends a GET request (following redirects) to the target. The hostname of the requested URL must resolve to a public IP.

Parameters

Query Parameters

target

required

string

A URL or host. If no scheme is present, ‘http://’ is prepended.

Example

example.com

Responses

200

Response metadata

application/json

object

required

boolean

query

required

The raw target as supplied

string

address

required

string

requestUrl

required

The URL actually requested

string

responseUrl

required

Final URL after redirects

string

statusCode

required

integer

statusText

required

string

headers

required

Response headers of the final response

object

key

additional properties

string

Example

{
  "ok": true,
  "query": "example.com",
  "address": "93.184.216.34",
  "requestUrl": "http://example.com",
  "responseUrl": "https://example.com/",
  "statusCode": 200,
  "statusText": "OK"
}

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 target, validation failure, or the website could not be reached

application/json

object

required

boolean

msg

required

string

query

string

address

string

requestUrl

string

Example

{
  "ok": false,
  "query": "example.com",
  "address": "93.184.216.34",
  "requestUrl": "https://example.com",
  "msg": "can't connect to the website"
}

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.