Introducing Official OnlyDNS SDKs: Type-Safe DNS Automation for Python, TypeScript, Go, and PHP

Adding or modifying records across distributed systems without transactional awareness can lead to accidental record overwrites or lost records.

Hardcoding API tokens or writing repetitive bearer token logic across microservices increases security exposure and maintenance overhead.

Parsing JSON error responses manually makes error handling brittle and complicates automated recovery workflows in production.

High-Level Atomic Record Helpers

Methods like addRecord(), removeRecord(), updateRecord(), and findRecords() automatically handle existing record fetching, deduplication, and atomic zone persistence.

100% System API Coverage

Full support for domain lifecycle (/dns), full zone record arrays (/dns/{domain}/records), automated DNSSEC (/dns/{domain}/dnssec), and cryptographic TSIG keys (/dns/tsig).

Zero Heavy Dependencies

Engineered with zero heavy runtime dependencies, utilizing standard libraries, native fetch, or native cURL bindings for near-zero startup overhead and minimal package footprint.

Optimized for AI Agents & MCP

Clear type definitions, deterministic structured outputs, and typed error classes make these SDKs ideal for LLM function calling, LangChain tools, CrewAI agents, and Model Context Protocol servers.

🐍 Python SDK PyPI

from onlydns import OnlyDNSClient

# Initialize client (picks up ONLYDNS_API_KEY from environment)
client = OnlyDNSClient()

# Add an A record with atomic safety
client.add_record(
    domain="example.com",
    name="api",
    record_type="A",
    value="192.0.2.1",
    ttl=300
)

# Enable 1-Click Automated DNSSEC
client.enable_dnssec("example.com")
print("DNSSEC enabled and zone signed!")

⚡ TypeScript / Node.js SDK npm

import { OnlyDNSClient } from '@onlydns/sdk';

const client = new OnlyDNSClient({
  apiKey: process.env.ONLYDNS_API_KEY
});

// Query records with pattern filtering
const aRecords = await client.findRecords('example.com', {
  name: 'api',
  type: 'A'
});

// Atomic batch updates
await client.addRecord('example.com', {
  name: 'staging',
  type: 'CNAME',
  records: ['edge.example.com'],
  ttl: 300
});

🐹 Go SDK Go Modules

package main

import (
    "context"
    "fmt"
    "github.com/onlydns/onlydns-sdk-go"
)

func main() {
    client, _ := onlydns.NewClient(onlydns.WithEnvAuth())
    
    // Add DNS record
    record, err := client.AddRecord(context.Background(), "example.com", onlydns.RecordInput{
        Name:    "app",
        Type:    "A",
        Records: []string{"192.0.2.50"},
        TTL:     300,
    })
    if err != nil {
        panic(err)
    }
    fmt.Println("Record created:", record.Name)
}

🐘 PHP SDK Composer

use OnlyDNS\OnlyDNSClient;

$client = new OnlyDNSClient();

// Add or update records
$client->addRecord('example.com', [
    'name' => 'webhook',
    'type' => 'A',
    'records' => ['192.0.2.75'],
    'ttl' => 300,
]);

// Inspect DNSSEC signing status
$dnssec = $client->getDnssecStatus('example.com');
echo "DNSSEC Enabled: " . ($dnssec->enabled ? 'Yes' : 'No');