API Documentation

The DNS Tools API provides programmatic access to all our DNS tools and services. This reference documentation covers authentication, endpoints, request/response formats, and examples.

Base URL

https://api.www12.dpdns.org/v1

Authentication

All API requests require authentication using an API key. You can generate an API key in your account settings. The API key should be included in the Authorization header of all requests:

Authorization: Bearer YOUR_API_KEY

Rate Limits

Free accounts are limited to 100 requests per hour. Premium accounts have higher limits based on their subscription tier. Rate limit information is included in the response headers:

• X-RateLimit-Limit: The maximum number of requests allowed per hour
• X-RateLimit-Remaining: The number of requests remaining in the current rate limit window
• X-RateLimit-Reset: The time at which the current rate limit window resets, in UTC epoch seconds

Response Format

All API responses are returned in JSON format. Successful responses have a 2xx status code and include the requested data. Error responses have a 4xx or 5xx status code and include an error message:

{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key provided is invalid or has expired."
  }
}