DNS API Overview

WAYSCloud DNS API provides managed DNS hosting with DNSSEC support, global anycast network, and programmatic zone management. Perfect for automating DNS configuration, implementing dynamic DNS, or building DNS-dependent applications.

What is WAYSCloud DNS?

WAYSCloud DNS is a premium managed DNS service built on a global anycast network. It provides high availability, low latency DNS resolution, and advanced security features including DNSSEC.

Key Features

Global Anycast Network

• Multiple points of presence worldwide
• Automatic routing to nearest DNS server
• Sub-10ms query response times globally
• 100% uptime SLA

DNSSEC Support

• Automatic key generation and rotation
• NSEC3 for enhanced security
• Full chain of trust validation
• Protection against cache poisoning

Advanced Record Types

• Standard: A, AAAA, CNAME, MX, TXT, NS
• Advanced: SRV, CAA, TLSA, SSHFP
• Geographic routing (future)
• Weighted round-robin (future)

API-First Design

• Full REST API for all operations
• Atomic zone updates
• Bulk record management
• Webhook notifications for changes

Use Cases

Dynamic DNS

• Update DNS records programmatically based on events
• Automatic failover between servers
• Blue-green deployments
• Canary releases

Infrastructure Automation

• Integrate with Terraform, Ansible, or custom tools
• Automatic DNS configuration during provisioning
• Synchronize DNS with service discovery
• GitOps workflows for DNS management

Email and Security

• SPF, DKIM, DMARC records for email authentication
• CAA records for certificate authority authorization
• TLSA records for DANE/TLS
• Security policy enforcement

Multi-Region Applications

• Geographic load balancing
• Disaster recovery failover
• Content delivery network integration
• Regional service endpoints

Base URL

https://api.wayscloud.services/v1/dns

All DNS API endpoints are prefixed with /v1/dns.

Authentication

All requests require a valid API key in the Authorization header:

Authorization: Bearer wayscloud_dns_prod_YOUR_API_KEY

See Authentication for detailed information about API keys.

Obtaining an API Key

1. Log in to WAYSCloud Console at https://my.wayscloud.services
2. Navigate to API Keys section
3. Click Create New Key
4. Select DNS as the service
5. Copy your API key (starts with wayscloud_dns_prod_)
6. Store the key securely

Security

Never expose API keys in client-side code. Use environment variables for key storage and implement key rotation every 90 days.

Quick Start

Creating a Zone

curl -X POST https://api.wayscloud.services/v1/dns/zones \
  -H "Authorization: Bearer wayscloud_dns_prod_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "dnssec_enabled": true,
    "default_ttl": 3600
  }'

Response:

{
  "zone_id": "zone_abc123",
  "domain": "example.com",
  "status": "pending",
  "dnssec_enabled": true,
  "default_ttl": 3600,
  "nameservers": [
    "grieg.wayscloud.no",
    "lindgren.wayscloud.se",
    "aalto.wayscloud.fi",
    "bohr.wayscloud.dk"
  ],
  "created_at": "2025-11-03T18:00:00Z"
}

Next Steps After Zone Creation:

1. Update your domain registrar to use WAYSCloud nameservers
2. Wait for DNS propagation (usually 24-48 hours)
3. Add DNS records to your zone

See Zone Management for complete zone operations.

Adding DNS Records

A Record (IPv4):

curl -X POST https://api.wayscloud.services/v1/dns/zones/zone_abc123/records \
  -H "Authorization: Bearer wayscloud_dns_prod_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "A",
    "name": "www",
    "value": "192.0.2.1",
    "ttl": 3600
  }'

MX Record (Mail Server):

curl -X POST https://api.wayscloud.services/v1/dns/zones/zone_abc123/records \
  -H "Authorization: Bearer wayscloud_dns_prod_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "MX",
    "name": "@",
    "value": "mail.example.com",
    "priority": 10,
    "ttl": 3600
  }'

See Record Management for all record operations and Record Types for detailed record type documentation.

DNS Concepts

Zones

A DNS zone represents a domain name and all its subdomains. For example:

• Zone: example.com
• Can contain records for: www.example.com, api.example.com, mail.example.com

Records

DNS records map names to values. Common types:

• A Record: Maps domain to IPv4 address
• AAAA Record: Maps domain to IPv6 address
• CNAME Record: Creates alias to another domain
• MX Record: Specifies mail servers
• TXT Record: Arbitrary text data (SPF, DKIM, verification)
• SRV Record: Service location (port and host for services)
• CAA Record: Certificate authority authorization

See Record Types for complete documentation.

TTL (Time To Live)

TTL specifies how long DNS resolvers should cache a record:

• Low TTL (60-300 seconds): Use before changes, for dynamic DNS
• Medium TTL (3600 seconds / 1 hour): Balanced approach
• High TTL (86400 seconds / 24 hours): Static records, lower query load

Lower TTL means faster propagation of changes but more DNS queries.

Rate Limits

Operation	Limit
Zone creation	10 per hour
Record creation	100 per minute
Record updates	100 per minute
Record deletion	100 per minute
Zone queries	1000 per minute
Record queries	1000 per minute

Exceeding rate limits results in HTTP 429 response. See Rate Limits for handling strategies.

Next Steps

• Zone Management - Create, list, update, and delete zones
• Record Management - Manage DNS records
• Record Types - Detailed record type reference
• DNSSEC - Enable and configure DNSSEC
• Bulk Operations - Import/export zones and batch operations
• Advanced Use Cases - Failover, blue-green deployments, email config
• Code Examples - Python and Node.js SDK examples

Support

For assistance with DNS configuration:

• Email: support@wayscloud.services
• Chat: https://mattermost.wayscloud.net
• Documentation: https://docs.wayscloud.services
• Status: https://status.wayscloud.services
• API Reference: https://api.wayscloud.services/v1/dns/openapi.json