NetDiag Documentation | Multi-Region Website Connectivity Diagnostics API

NetDiag is a network diagnostics API. It runs DNS, TLS, HTTP, and ping checks on any target from 3 geographic regions (US, EU, Asia-Pacific) simultaneously and returns a unified JSON response.

What You Get

Check	What It Does
Ping	ICMP latency measurement with TCP fallback for cloud environments
DNS	Resolution + propagation status (detects when regions resolve to different IPs)
TLS	Certificate validity, expiry date, issuer, protocol version
HTTP	Status code, response time, endpoint availability

Quick Example

curl "https://api.netdiag.dev/v1/checks?host=example.com"

Response:

{
  "status": "Healthy",
  "quorum": { "required": 2, "total": 3, "met": true },
  "regions": [
    { "region": "us-west", "status": "Healthy", "ping": {...}, "dns": {...}, "tls": {...}, "http": {...} },
    { "region": "eu-central", "status": "Healthy", ... },
    { "region": "ap-southeast", "status": "Healthy", ... }
  ]
}

SDK Clients

Choose your preferred language to integrate NetDiag into your applications:

JavaScript

Node.js & Browser

npm i @netdiag/client

Full TypeScript support. Works in Node.js 18+ and modern browsers.

.NET

C# / .NET 8+

dotnet add package Xakpc.NetDiag.Client

Dependency injection ready. Supports async/await and IHttpClientFactory.

Python

Python 3.10+

pip install netdiag-client

Context manager support. Type hints and dataclasses included.

GitHub Action

CI/CD Integration

uses: XAKPC-Dev-Labs/netdiag-check@v1

Run multi-region health checks in your deployment workflows.

SDK Methods

All clients implement these methods:

Method	Description
`check(host)`	Run full diagnostics on a target
`checkPrometheus(host)`	Get results in Prometheus metrics format
`isHealthy(host)`	Quick boolean health check
`getStatus(host)`	Get status enum (Healthy/Warning/Unhealthy)

Resources

Response Schema Guide

Field-by-field breakdown of the JSON response

API Reference

Interactive OpenAPI documentation