Dataczar
Browse helpers

API Reference / checks / status-check

Fetch a URL and report status, timing, and redirect info.

This GET-first endpoint downloads a public URL (HEAD+GET fallback) and returns status metadata, response headers, and optional body snippet. Useful for uptime checks and lightweight monitors.

GETPOST/checks/status-check

Parameters

Query Parameters

NameTypeDescription
urlstring · requiredAbsolute URL to fetch (http/https).
methodstringHTTP method to use.
timeoutnumberTimeout in seconds (max 30).
max_redirectsintegerMaximum redirects to follow.
include_bodybooleanWhen true, include first 1024 bytes of body (text only).
dryrunbooleanDryrun simulates the response shape without performing network I/O.

All helper calls accept your Dataczar key via the ak query parameter. Need one? Create or copy a key on Dataczar Connect and drop it into each request.

Responses

Status 200

Status fetched (or simulated in dryrun).

{
  "ok": true,
  "data": {
    "url": "https://www.dataczar.com/",
    "status_code": 200,
    "final_url": "https://www.dataczar.com/",
    "redirect_count": 0,
    "duration_ms": 231,
    "headers": {
      "content-type": "text/html; charset=utf-8"
    },
    "body_preview": "<!doctype html>..."
  },
  "meta": {
    "service": "test/status-check",
    "dryrun": false,
    "request_id": "req_123"
  }
}

Examples

Request

"GET /test/status-check?url=https://example.com&ak=demo"

Response

{
  "ok": true,
  "data": {
    "url": "https://example.com",
    "status_code": 200,
    "final_url": "https://example.com",
    "redirect_count": 0,
    "duration_ms": 180,
    "headers": {
      "server": "ECS"
    }
  },
  "meta": {
    "dryrun": false
  }
}

Request

"GET /test/status-check?url=https://example.com&dryrun=1"

Response

{
  "ok": true,
  "data": {
    "url": "https://example.com",
    "status_code": 200,
    "final_url": "https://example.com",
    "redirect_count": 0,
    "duration_ms": 0,
    "headers": {}
  },
  "meta": {
    "dryrun": true
  }
}

Test Contracts

[
  {
    "name": "reject_missing_url",
    "method": "GET",
    "params": {},
    "expect_status": 400
  },
  {
    "name": "dryrun_skip_fetch",
    "method": "GET",
    "params": {
      "url": "https://example.com",
      "dryrun": true
    },
    "expect": {
      "status_code": 200
    }
  }
]

File uploads (multipart form-data)

Attach PDFs or images as multipart fields. We'll fill in the field names for you.

Files
file

Query parameters

Equivalent curl
Grab your Dataczar API key
Every helper runs with the same simple API key. Sign in (or create a free Dataczar account) at Dataczar Connect to issue keys in seconds, then drop the key into any `ak=` parameter and start shipping.
Get your API keyBrowse helpers
Tip: reuse the same key across these helpers, or rotate keys per project from the Connect dashboard.