Developers

XHCDNS API

Programmable infrastructure — manage DNS, subdomains, and TLS from your own apps.

Overview

The XHCDNS API exposes the same operations that power our console: DNS zones and records, free subdomain requests, and TLS issuance. The base URL is https://xhcdns.com/api.

Base URL: https://xhcdns.com/api
Auth: OAuth 2.0 · PKCE
Format: JSON

Authentication

XHCDNS uses OAuth 2.0 with PKCE. Authorize at oauth.xhcdns.com, then send your access token as an Authorization: Bearer header.

Example request

# List your DNS zones
curl https://xhcdns.com/api/dns/zones \
  -H "Authorization: Bearer $TOKEN"

Replace $TOKEN with your OAuth access token.

Common operations

GET/api/dns/zonesList your DNS zones

POST/api/subdomainsRequest a free subdomain

POST/api/tls/issueIssue a TLS certificate

PUT/api/dns/records/{id}Update a DNS record