Domain Reseller API Nedir?

Yeni bir hosting şirketi kurdunuz.

Müşterileriniz sizden domain satın almak istiyor. Fakat ICANN akreditasyonu almak yüz binlerce dolarlık yatırım, hukuki süreçler ve 7/24 operasyonel yük demek. Registry sözleşmeleri, abuse yönetimi, teknik uyumluluk...

İyi haber şu ki bunların hiçbirini yapmak zorunda değilsiniz.

Domain Reseller API tam da bu boşluğu kapatır: ICANN akrediteli bir altyapının tüm teknik kapasitesini REST çağrılarıyla kullanırsınız; müşteri ilişkisi, fiyatlandırma ve marka deneyimi tamamen sizin kontrolünüzde kalır. Bir hosting firması, SaaS girişimi, web ajansı veya kurumsal IT ekibi olsanız da bu rehber entegrasyon için ihtiyacınız olan her şeyi kapsıyor.

Bu rehber özetle şunları kapsıyor:

• ✔ Registry, Registrar ve Reseller hiyerarşisi — kim kime ne satıyor
• ✔ REST API: kimlik doğrulama, Reseller ID, API Key ve OT&E erişimi
• ✔ cPanel değil; WHMCS, WiseCP, HostBill, Blesta ve ClientExec entegrasyonları
• ✔ Sandbox'tan production'a: OT&E URL'leri, test kimlik bilgileri, gerçek API endpoint'leri
• ✔ DNS, DNSSEC, Glue Record, Transfer, Restore, WHOIS — her operasyon API'den
• ✔ Yaygın hatalar, rate limit, hata yönetimi ve performans önerileri

Domain Ekosistemine Giriş: Registry, Registrar, Reseller ve ICANN

Domain adı sektörü, birbiriyle sıkı sözleşme ilişkileri içinde olan üç katmanlı bir yapı üzerine kurulu. Bu yapıyı anlamadan bir Reseller API'si kullanmak mümkün ama bu API'nin aslında ne yaptığını kavramak çok daha zor.

ICANN Nedir?

ICANN (Internet Corporation for Assigned Names and Numbers), alan adı sisteminin küresel koordinasyon kuruluşudur. .com, .net ve yüzlerce ccTLD ile yeni gTLD'nin kimler tarafından, hangi teknik ve politika standartlarına göre yönetileceğini belirler. Ancak ICANN bizzat domain satmaz; bu yetkiyi akredite Registrar'lara verir.

Registry Nedir?

Registry, belirli bir TLD'nin veritabanını ve altyapısını yöneten kuruluştur. Örneğin Verisign, .com ve .net Registry'sidir; PIR, .org'un Registry'sidir. Registry'ler yalnızca Registrar'larla çalışır, doğrudan son kullanıcıyla muhatap olmaz. Bir .com domain'in fiyatı ICANN tarafından Verisign ile müzakere edilen toptan birim maliyeti üzerinden belirlenir.

Registrar Nedir?

ICANN tarafından akredite edilmiş, Registry ile doğrudan entegrasyonu olan kuruluşlardır. Domain satabilir, transfer yapabilir, WHOIS veri tabanına yazabilir ve EPP protokolü üzerinden Registry sunucularıyla iletişim kurabilirler. Bir Registrar olmak için ICANN akreditasyonu, teknik altyapı ve belirli bir güvenlik teminatı gerekir. Maliyet ve operasyonel yük yüksektir.

Reseller Nedir?

Reseller, bir Registrar'ın altyapısını ve ICANN akreditasyonunu kullanarak domain satışı yapan üçüncü taraftır. Reseller olmak için ICANN akreditasyonuna gerek yoktur. Sadece güvenilir bir Registrar (veya Registrar seviyesinde altyapı sunan bir platform) ile çalışmanız yeterlidir. Kâr marjınızı, fiyatlarınızı ve müşteri deneyiminizi kendiniz belirlersiniz; arka planda teknik altyapı Registrar tarafından taşınır.

Domain Reseller API Nedir?

Domain Reseller API Nedir? (Hızlı Cevap)

Pratikte ne anlama gelir? Müşteriniz sitenizde bir domain aradığında, arka planda bir API sorgusu Registrar'ın altyapısına gider ve sonuç milisaniyeler içinde sayfanıza döner. Müşteri ödemeyi tamamladığında, API otomatik olarak domain kaydını gerçekleştirir, DNS ayarlarını tanımlar ve müşteriye aktivasyon e-postası gönderir. Siz bu süreçte hiçbir manuel işlem yapmadan yüzlerce domain'i otomatik olarak yönetebilirsiniz.

Registrar Olmak mı, Reseller Olmak mı? Karar Tablosu

Sonuç: 40.000+ aktif reseller bu modeli seçti.

Registrar olmak çok az sayıda büyük platform için anlamlıdır. Geri kalan herkes için Reseller API, teknik yükü devretirken kontrolü elinizde tutmanın en akıllıca yoludur.

Bir Domain Reseller API şunları yapabilmeli:

• ✔ Availability Check — Domain müsaitlik sorgusu
• ✔ Register — Domain kaydı
• ✔ Transfer — Başka Registrar'dan taşıma
• ✔ Renew — Yenileme
• ✔ Restore — Silinmiş domain kurtarma
• ✔ Delete — İptal
• ✔ Modify — Nameserver, DNS, WHOIS güncelleme
• ✔ WHOIS / RDAP Sorgusu
• ✔ Lock / Unlock — Transfer kilidi
• ✔ Auth Code (EPP Key) Alma

REST API Neden SOAP'ın Yerini Aldı?

Domain sektörünün eski nesil entegrasyonları büyük ölçüde SOAP (Simple Object Access Protocol) tabanlıydı. XML envelope'lar, WSDL dosyaları, namespace tanımlamaları... Her request yazmak başlı başına bir uğraştı.

REST (Representational State Transfer) ise HTTP dinamiklerine oturan, JSON veri formatıyla çalışan ve çok daha az boilerplate gerektiren bir mimaridir. Faydaları somut:

Domain Name API, bu dönüşümü tamamladı: REST API şu anda canlı ve production'da kullanılıyor. SOAP'tan REST'e geçiş mevcut entegrasyonlar için bir yeniden yapılandırma gerektirebilir, ancak modern geliştirme süreçleri açısından ciddi bir hız ve esneklik kazanımı sağlar.

REST API entegrasyon belgelerine ulaşmak için API Integration sayfasını inceleyebilirsiniz.

Domain Name API: Gerçek Rakamlar ve Konumlama

Bir API platformu seçerken bağlamı görmek önemlidir. Domain Name API'nin 2026 itibarıyla doğrulanmış rakamları:

Rakip karşılaştırması açısından bakıldığında: ResellerClub 300+, GoDaddy 200+, ENOM 500+ TLD sunarken Domain Name API 800+ TLD ile öne çıkıyor. Dahası, Blesta, WiseCP ve ClientExec entegrasyonları — rakiplerinin hiçbirinde mevcut değil.

API Kimlik Doğrulama: Reseller ID ve API Key

REST API erişiminde kullanıcı adı ve parola kullanılmaz. Kimlik doğrulama, size özel iki bileşenle sağlanır:

Username (UUID format): Reseller panelinize giriş yaparken kullandığınız, UUID formatındaki kullanıcı adınız. Örnek: fd2bea54-99ea-16b6-c195-3a1b9079df00

API Token (Password): Aynı panele girişteki şifreniz; REST modunda API token olarak kullanılır.

Önemli: Production ve OT&E ortamları için kimlik bilgileri AYNIDIR — tek bir hesap her iki ortamda da geçerlidir. Kütüphane, username'in UUID formatında olup olmadığını kontrol ederek REST mi SOAP mı kullanacağını otomatik seçer.

SOAP vs REST Mod Algılama (PHP Kütüphanesi Örneği)

// SOAP modu (eski/legacy) — düz kullanıcı adı

$dna = new DomainNameApiDomainNameAPI_PHPLibrary('myreseller', 'mypassword');

// REST modu (yeni) — UUID formatında kullanıcı adı

$dna = new DomainNameApiDomainNameAPI_PHPLibrary(

    'fd2bea54-99ea-16b6-c195-3a1b9079df00',

    'your-api-token'

);

// Her iki mod da aynı method çağrılarını kullanır

$details = $dna->GetResellerDetails();

$domains = $dna->GetList([]);

API Key hiçbir zaman client-side kodda (tarayıcıda çalışan JavaScript, mobil uygulama vb.) açık olarak bulunmamalıdır. Tüm API çağrıları sunucu tarafından yapılmalı; API Key sadece backend'de tutulmalıdır.

OT&E (Operational Test & Evaluation) Ortamı

OT&E, gerçek bir para ya da domain kaydı oluşturmadan tüm API entegrasyonunuzu test etmenizi sağlayan izole bir ortamdır. ICANN Registrar akreditasyon sürecinde de zorunlu olan bu yaklaşım, Domain Name API'nin reseller ekosistemi için kritik bir bileşen.

Neden OT&E Olmadan Production'a Geçmemelisiniz?

Hatalı bir Register çağrısı gerçek bir domain kaydı oluşturabilir ve ücret tahsil edilebilir.

Transfer Auth Code'u yanlış yönetilen bir akış, müşteri domain'ini kilide sokabilir.

Rate limit aşımı, production'da tüm entegrasyonunuzu anlık olarak durdurabilir.

DNS kaydı yazım hataları, müşteri sitelerini aylar boyunca etkisizleştirebilir.

OT&E Erişim Bilgileri

OT&E ortamında gerçekleştirilen işlemler hiçbir şekilde gerçek kayıt, yenileme, transfer veya ticari işlem oluşturmaz. Test sonuçlarınız sisteme kaydedilir ama Registry ile senkronize olmaz.

OT&E URL'lerini not alın:

Production Swagger: https://api.domainresellerapi.com/swagger/index.html

OT&E Swagger: https://ote.domainresellerapi.com/swagger/index.html

Production ve OT&E için kimlik bilgileri AYNIDIR; yalnızca base URL farklıdır. Kütüphane UUID username'i görünce REST modunu, düz username görünce SOAP modunu seçer.

10 dakika içinde ne yapabilirsiniz?

Ücretsiz reseller hesabınızı oluşturun, OT&E ortamında ilk API çağrınızı yapın ve gerçek kayıt oluşturmadan entegrasyonunuzu test edin. Kodunuzu doğruladıktan sonra aynı yapı birkaç tıkla production ortamına taşınır.

• → Ücretsiz OT&E Hesabı Oluştur ve İlk Çağrını Yap

Temel API Operasyonları: Kayıt, Transfer, Yenileme, Restore

1. Domain Müsaitlik Sorgusu (Availability Check)

Her domain satış akışının başlangıç noktasıdır. Tek domain veya çoklu sorgu (bulk check) yapılabilir.

// Domains ve TLD'ler ayrı dizi olarak girilir

// $dna->CheckAvailability(domainlar[], tld'ler[], period, command)

$result = $dna->CheckAvailability(

    ['hello', 'world123x0', 'myshop'],  // domain adları (uzantısız)

    ['com', 'net', 'org'],              // TLD listesi

    1,                                  // kayıt süresi (yıl)

    'create'                            // komut

);

// Örnek yanıt:

// [TLD]    => com

// [DomainName] => hello

// [Status] => notavailable

// [Price]  => 10.8100

// [Currency] => USD

//

// [TLD]    => com

// [DomainName] => world123x0

// [Status] => available

// [Price]  => 10.8100

2. Domain Kaydı (Registration)

Kayıt isteğinde domain adı, kayıt süresi (yıl), WHOIS iletişim bilgileri (registrant, admin, tech, billing) ve nameserver bilgileri gereklidir.

$contact = [

    "FirstName"        => 'Ali',

    "LastName"         => 'Yılmaz',

    "Company"          => 'Örnek Şirket A.Ş.',

    "EMail"            => 'ali@example.com',

    "AddressLine1"     => 'Atatürk Cad. No:1',

    "AddressLine2"     => '',

    "AddressLine3"     => '',

    "City"             => 'İstanbul',

    "Country"          => 'TR',

    "Fax"              => '2121234567',

    "FaxCountryCode"   => '90',

    "Phone"            => '5001234567',

    "PhoneCountryCode" => 90,

    "Type"             => 'Contact',

    "ZipCode"          => '34000',

    "State"            => 'Istanbul'

];

$dna->RegisterWithContactInfo(

    'example.com',  // domain adı

    1,              // kayıt süresi (yıl)

    [

        'Administrative' => $contact,

        'Billing'        => $contact,

        'Technical'      => $contact,

        'Registrant'     => $contact

    ],

    ["ns1.example.com", "ns2.example.com"],  // nameserver'lar

    true,   // WHOIS gizliliği

    false   // transfer kilidi

);

// Başarılı yanıt:

// [result] => OK

// [data][DomainName]   => example.com

// [data][Status]       => clientTransferProhibited

// [data][AuthCode]     => Xy9#mK2$pL5@vN8

// [data][LockStatus]   => true

3. Domain Transfer

Transfer işlemi için kaynak Registrar'dan alınan EPP/Auth Code zorunludur. Transferden önce domain'in Transfer Lock (Registrar Lock) kaldırılmış ve son 60 gün içinde kayıt veya transfer edilmemiş olması gerekir.

$dna->Transfer('example.com', 'EPP_AUTH_CODE', 1);

// Başarılı yanıt:

// [result] => OK

4. Domain Yenileme (Renew)

Yenileme işlemi sona erme tarihinden önce yapılmalıdır. Bazı TLD'lerde 30 güne kadar ek süre (grace period) sağlanır.

$dna->Renew('example.com', 1);

// Başarılı yanıt:

// [result]               => OK

// [data][ExpirationDate] => 2027-03-15T10:00:00

5. Restore (Silinmiş Domain Kurtarma)

Redemption Grace Period içinde (genellikle silinmeden sonraki 30 gün) olan bir domain, ek ücret karşılığında kurtarılabilir. Bu süre TLD'ye göre değişir; .com için Registry (Verisign) redemption ücretleri geçerlidir.

WHOIS, RDAP ve DNS Yönetimi

WHOIS Nedir? (Hizli Cevap)

WHOIS Nedir?

WHOIS, domain sahipliği bilgisine erişim sağlayan klasik protokoldür. Port 43 üzerinden çalışır. Ancak GDPR ve yerel veri koruma mevzuatının etkisiyle Kayıtlı kişi bilgileri büyük ölçüde maskelenir hale geldi; bu boşluğu doldurmak için RDAP geliştirildi.

RDAP: WHOIS'in Halefi

RDAP (Registration Data Access Protocol), HTTPS üzerinden JSON formatında yanıt veren, ICANN'in desteklediği modern bir protokoldür. Hem makine okunabilirliği hem kimlik doğrulama desteği açısından WHOIS'ten üstündür. API entegrasyonlarında RDAP tercih edilmelidir.

DNS Yönetimi

Domain Name API, kayıtlı domain'lerin DNS kayıtlarını API üzerinden yönetmenizi sağlar. Desteklenen kayıt tipleri:

DNSSEC, Glue Record ve Child Nameserver

DNSSEC Nedir? (Hizli Cevap)

DNSSEC Nedir?

DNSSEC (Domain Name System Security Extensions), DNS yanıtlarının kriptografik imzayla doğrulanmasını sağlar. DNS spoofing ve cache poisoning saldırılarına karşı ek bir güvenlik katmanı sunar. API üzerinden DNSSEC aktivasyonu için DS (Delegation Signer) kaydının Registry'e iletilmesi gerekir.

Glue Record Nedir?

Kendi alan adınız üzerine nameserver tanımlıyorsanız (örneğin ns1.sizinsite.com) ve bu nameserver'ın IP adresi de aynı domain altındaysa döngüsel bir bağımlılık oluşur. Bu sorunu çözmek için Glue Record kullanılır: Registry'e nameserver'ın IP adresi doğrudan kaydedilir.

// Örnek: ns1.sizinsite.com için glue record eklemek

POST /domain/glue

{

  "resellerId": "RESELLER_ID",

  "apiKey": "API_KEY",

  "domainName": "sizinsite.com",

  "host": "ns1",

  "ipv4Address": "192.0.2.10"

}

Child Nameserver (Host Object)

Child nameserver kaydı, domain'inize ait bir alt alan adının Registry sisteminde bağımsız bir nesne olarak tanımlanmasıdır. WHMCS veya özel bir DNS altyapısı üzerine kurulan çözümlerde bu adım sıkça gereklidir.

Toplu İşlemler: Bulk Domain ve Rate Limit

Rate Limit Nedir? (Hizli Cevap)

Yüzlerce ya da binlerce domain'i yöneten bir reseller için bireysel API çağrılarına güvenmek hem verimsiz hem de risk barındırır. Bulk operasyonlar bu ihtiyacı karşılar, ancak dikkat edilmesi gereken sınırlamalar var.

Rate Limit ve Throttling

Domain Name API, sistemin istikrarını ve adil kullanımı korumak amacıyla rate limit uygular. Bu limitler tek bir reseller'ın aşırı istek göndererek altyapıyı etkilemesini önler. Limitler endpoint'e ve reseller seviyesine göre farklılık gösterebilir.

Rate Limit için uygulanan başlıca kurallar:

Kısa sürede art arda çok sayıda istek göndermek 429 (Too Many Requests) hatası döndürür.

Bulk check için birden fazla domain'i tek request body'ye eklemek (dizi gönderimi) tavsiye edilen yoldur.

Tekrar eden sorgular için response'u cache'lemek toplam istek sayısını azaltır.

Rate limit yönetimine ilişkin detaylar için Domain Name API Bilgi Bankası'ndaki Rate Limit makalesini inceleyin.

Rate limit politikasının detayları için Domain API Rate Limit, Throttling & Bulk Usage Policy sayfasına bakın.

Premium Domain ve Özel Fiyatlandırma

Premium Domain Nedir? (Hizli Cevap)

Bazı domain isimleri Registry tarafından "premium" olarak etiketlenir ve standart kayıt ücretinin çok üzerinde fiyatlandırılır. Bir reseller olarak premium domain'leri doğru yönetmek gelir kaybını önler.

Availability check yanıtı, bir domain'in premium olup olmadığını ve premium kayıt fiyatını döndürmelidir. Bu bilgiyi müşteriye göstermeden işlemi tamamlamak, sizi beklenmedik maliyetlerle karşı karşıya bırakabilir.

// Availability check yanıtı - premium domain örneği

{

  "domainName": "casino.com",

  "available": true,

  "isPremium": true,

  "premiumPrice": 2500000.00,

  "currency": "USD"

}

Fiyatlandırma kademe sistemi açısından: Domain Name API, Reseller, Premium, Platinum ve VIP olmak üzere dört fiyatlandırma katmanı sunuyor. Satış hacmine bağlı olarak daha düşük toptan fiyatlara erişim sağlanıyor; .com için VIP/Platinum fiyatı 10,81 USD'den başlıyor.

Güncel toptan domain fiyatlarını görmek için Domain Fiyatları sayfasını ziyaret edin.

White Label ve Sub-Reseller Sistemi

White Label Domain Reseller Nedir? (Hizli Cevap)

Musterilerinizin yalnizca kendi markanizi gorurken arka planda Domain Name API altyapisini kullandiginiz sistemdir. Fatura, panel ve iletisimlerde Domain Name API gorunmez.

White Label Nedir?

White label, arka planda Domain Name API altyapısını kullanırken müşterilerinizin yalnızca kendi markanızı görmesini sağlar. Müşteri panel arayüzünüzde, faturalarında, e-postalarında ve domain yönetim aracında Domain Name API'ye herhangi bir referans bulunmaz.

Bu yapı özellikle hosting firmaları ve ajanslar için kritik: müşteri, altyapınızın kimden geldiğini bilmeden tam markalaşmış bir deneyim yaşar.

Sub-Reseller Sistemi

Alt reseller (sub-reseller) yapısı, kendi bayi ağınızı oluşturmanızı sağlar. Kendi reseller hesabınız altında başka firmalara veya bağımsız bayilere alt hesaplar tanımlayabilir, onların toptan fiyatlarını ve kota limitlerini yönetebilirsiniz. Bu özellik özellikle hosting dağıtım kanalı işleten büyük ajanslar ve IT dağıtıcıları için değer taşır.

Sub-reseller sisteminin size sunduğu avantajlar:

• • Kendi bayi ağınızı yönetin — her bayinin fiyatını ayrı belirleyin
• • Bayilerinizin domain portföyünü merkezi yönetimden izleyin
• • Her baye için API erişimini bağımsız olarak açıp kapatabilirsiniz
• • Çok katmanlı gelir modeli oluşturun

Entegrasyon Yolları: WHMCS, WiseCP, HostBill, Blesta, ClientExec

Domain satışını kendi geliştirdiğiniz bir altyapıyla yönetmek yerine mevcut hosting billing sistemlerine entegre etmek çoğu zaman daha hızlı ve daha güvenilirdir. Domain Name API'nin desteklediği platformlar:

WHMCS

Web Hosting Manager Complete Solution (WHMCS), dünya genelinde en yaygın kullanılan hosting billing ve client management sistemidir. Domain Name API, WHMCS için özel bir modül sağlar. Bu modül kurulduktan sonra WHMCS otomatik olarak domain sorgulamayı, kaydı, transferi ve yenilemeyi API üzerinden yönetir.

Modül kurulumu GitHub üzerinden erişilebilir: github.com/domainreseller

WHMCS içinde domain provisioning'i ayarlamak için Setup > Products/Services > Domain Registrars yolunu izleyin

Modül sürüm uyumluluğunu kontrol etmek için Knowledge Base'e başvurun

WHMCS entegrasyonunun detayları için WHMCS sayfasını inceleyin.

WiseCP

WiseCP, modern arayüzü ve çok dilli desteğiyle özellikle Türkiye ve yakın çevresindeki hosting firmalarının tercih ettiği bir billing panelidir. Domain Name API'nin WiseCP modülü, tam entegrasyon sağlar.

WiseCP entegrasyon rehberi için WiseCP sayfasına bakın.

HostBill

HostBill, gelişmiş API desteği ve çok dilli yapısıyla özellikle kurumsal hosting operasyonlarında tercih edilen bir platform. Domain Name API modülü HostBill entegrasyon mağazasında mevcuttur.

HostBill entegrasyonu için HostBill sayfasına göz atın.

Blesta

Açık kaynak yaklaşımı ve esnek lisans yapısıyla dikkat çeken Blesta, domain hosting sektöründe ciddi bir kullanıcı kitlesine sahip. Domain Name API'nin Blesta modülü, tam domain yaşam döngüsü yönetimini kapsıyor.

Blesta için entegrasyon sayfasına bakın.

ClientExec

Web hosting firmalarına yönelik billing ve destek yazılımı olan ClientExec, Domain Name API ile tam entegrasyon destekliyor.

ClientExec için ClientExec entegrasyon sayfasını inceleyin.

Diğer Sistemler

FOSSBilling, HostFact ve Upmind gibi platformlar da API entegrasyonu üzerinden Domain Name API ile çalışabilir. Özel geliştirme için REST API doğrudan kullanılabilir.

Dil Bazlı Entegrasyon: .NET, PHP, Python, Node.js

Domain Name API'nin REST mimarisi, dil bağımsız çalışır. HTTPS üzerinden JSON gönderebilen her dil ya da framework kullanılabilir. Aşağıda yaygın dillerde temel bir domain müsaitlik sorgusu örneği yer alıyor:

PHP (Resmi Kütüphane)

// Kurulum: composer require domainreseller/php-dna

require_once __DIR__.'/vendor/autoload.php';

use DomainNameApiDomainNameAPI_PHPLibrary;

// UUID formatındaki username → REST modu otomatik seçilir

// OT&E için aynı kimlik bilgileri kullanılır

$dna = new DomainNameAPI_PHPLibrary(

    'fd2bea54-99ea-16b6-c195-3a1b9079df00',  // UUID username

    'your-api-token'                          // API token

);

// Domain müsaitlik kontrolü

// $dna->CheckAvailability(domainlar[], tld'ler[], yıl, komut)

$result = $dna->CheckAvailability(['hello', 'myshop'], ['com', 'net'], 1, 'create');

// Reseller bakiyesi

$reseller = $dna->GetResellerDetails();

echo 'Bakiye: ' . $reseller['balance'] . ' ' . $reseller['currency'];

Python

import requests

# OT&E: ote.domainresellerapi.com  |  Production: api.domainresellerapi.com

BASE_URL = "https://ote.domainresellerapi.com"

# REST API: HTTP Basic Auth — UUID username + API token

UUID_USERNAME = "fd2bea54-99ea-16b6-c195-3a1b9079df00"

API_TOKEN = "your-api-token"

auth = (UUID_USERNAME, API_TOKEN)

# Domain müsaitlik sorgusu

# Domains ve TLD'ler ayrı parametreler olarak gönderilir

response = requests.get(

    f"{BASE_URL}/api/domain/check",

    params={

        "domainNames": "hello,myshop",

        "tlds": "com,net",

        "period": 1,

        "command": "create"

    },

    auth=auth

)

data = response.json()

print(data)  # [{"TLD":"com","DomainName":"hello","Status":"notavailable",...}, ...]

Node.js

const fetch = require('node-fetch');

// OT&E: ote.domainresellerapi.com  |  Production: api.domainresellerapi.com

const BASE_URL = 'https://ote.domainresellerapi.com';

// HTTP Basic Auth — UUID username + API token

const UUID_USERNAME = 'fd2bea54-99ea-16b6-c195-3a1b9079df00';

const API_TOKEN = 'your-api-token';

const basicAuth = 'Basic ' + Buffer.from(`${UUID_USERNAME}:${API_TOKEN}`).toString('base64');

async function checkAvailability(domains, tlds) {

  const params = new URLSearchParams({

    domainNames: domains.join(','),

    tlds: tlds.join(','),

    period: 1,

    command: 'create'

  });

  const response = await fetch(`${BASE_URL}/api/domain/check?${params}`, {

    headers: { 'Authorization': basicAuth }

  });

  return response.json();

}

checkAvailability(['hello', 'myshop'], ['com', 'net'])

  .then(data => console.log(data));

.NET (C#)

using System.Net.Http;

using System.Net.Http.Headers;

using System.Text;

// OT&E: ote.domainresellerapi.com  |  Production: api.domainresellerapi.com

const string BASE_URL = "https://ote.domainresellerapi.com";

const string UUID_USERNAME = "fd2bea54-99ea-16b6-c195-3a1b9079df00";

const string API_TOKEN = "your-api-token";

var client = new HttpClient();

// HTTP Basic Auth

var credentials = Convert.ToBase64String(Encoding.ASCII.GetBytes($"{UUID_USERNAME}:{API_TOKEN}"));

client.DefaultRequestHeaders.Authorization =

    new AuthenticationHeaderValue("Basic", credentials);

// Domain müsaitlik sorgusu

var url = $"{BASE_URL}/api/domain/check?domainNames=hello,myshop&tlds=com,net&period=1&command=create";

var response = await client.GetAsync(url);

var result = await response.Content.ReadAsStringAsync();

Console.WriteLine(result);

Tüm bu örnekler OT&E ortamını hedef alıyor. Production'a geçiş için base URL'i api.domainresellerapi.com olarak değiştirin; kimlik bilgileri her iki ortamda aynıdır. Not: Gerçek endpoint path yapısı için resmi Swagger dokümantasyonunu (api.domainresellerapi.com/swagger) referans alın — yukarıdaki örnekler kavramsal akışı göstermektedir.

Güvenlik: IP Whitelist, API Key Yönetimi, HTTPS

Domain API Guvenlik Kurallari (Hizli Cevap)

Domain API entegrasyonu güvenlik açıkları barındırdığında sonuçları ağır olabilir: yetkisiz domain transferleri, müşteri verilerinin sızması ya da kötü niyetli kişilerin hesabınız üzerinden domain kaydettirmesi. Temel güvenlik katmanları:

IP Whitelist

Reseller panelinizde yalnızca belirli IP adreslerinden (backend sunucularınızın IP'leri) gelen API isteklerinin kabul edilmesini sağlayan bir whitelist tanımlayabilirsiniz. Bu önlem, API Key'in ele geçirilmesi durumunda bile yetkisiz erişimi engeller.

API Key Rotasyonu

API Key'i belirli aralıklarla yenilemek ve eski key'i devre dışı bırakmak, uzun süreli maruz kalma riskini azaltır. Özellikle bir çalışan ayrılığı veya sistem ihlali şüphesi durumunda key rotasyonu hemen yapılmalıdır.

HTTPS Zorunluluğu

REST API yalnızca HTTPS üzerinden kullanılmalıdır. HTTP üzerinden yapılan istekler hem verinin ele geçirilmesine hem de man-in-the-middle saldırılarına kapı aralar. Production ve OT&E endpoint'lerinin her ikisi de HTTPS'i zorunlu kılar.

Backend-Only API Çağrıları

API Key ve Reseller ID, client-side kodda (tarayıcıda çalışan JavaScript, mobil uygulama HTML'i vb.) hiçbir zaman açık metin olarak yer almamalıdır. Tüm API çağrıları sunucu taraflı olmalı; ön yüz (frontend) yalnızca kendi backend'inizle konuşmalıdır.

Migration: Mevcut Domain Portföyünü Taşıma

Şu anda başka bir reseller platformu kullanıyorsanız ve Domain Name API'ye geçmek istiyorsanız, migration süreci iyi planlanmazsa müşteri kesintisine yol açabilir.

Migration Süreci Genel Akışı

• 1.Mevcut domain portföyünüzü dışa aktarın (CSV veya API üzerinden liste çekin).
• 2.Her domain için Transfer Auth Code (EPP Key) alın.
• 3.Domain'lerin Transfer Lock'larını kaldırın.
• 4.Admin contact e-posta adreslerinin güncel ve erişilebilir olduğunu doğrulayın (özellikle .com, .net, .org, .info gibi generic TLD'lerde transfer onayı bu adrese gider).
• 5.Toplu transfer isteğini Domain Name API destek ekibiyle koordineli başlatın.
• 6.Her domain'in transfer durumunu API üzerinden izleyin.
• 7.Transfer tamamlandıktan sonra DNS ayarlarını doğrulayın.

Domain Name API'nin kendi açıklamasına göre ekip, binlerce domain'in transferini daha önce başarıyla yönetti ve bu konuda kapsamlı deneyime sahip. Büyük ölçekli taşımalarda destek ekibinden proaktif yardım talep etmek süreyi kısaltır.

Domain Name API ücretsiz migration desteği sunuyor.

Domain listenizi hazırlayın ve destek kanalı üzerinden paylaşın.

Ekip, transfer sürecini sizinle koordineli yürütür.

Hata Yönetimi: API Error Kodları ve Çözümleri

Exponential Backoff Nedir? (Hizli Cevap)

Sağlam bir entegrasyon, yalnızca başarılı yanıtları değil hataları da beklentiye dahil eder. Domain API entegrasyonlarında en sık karşılaşılan hata kategorileri:

Exponential Backoff Nedir ve Neden Önemlidir?

Rate limit (429) veya geçici server hatası (503) ile karşılaştığınızda, aynı isteği hemen tekrar göndermek sorunu çözmez — aksine oranı daha da artırır. Exponential backoff stratejisinde her başarısız denemeden sonra bekleme süresi katlanarak artar: ilk denemeden sonra 1 saniye, ikincisinde 2 saniye, üçüncüsünde 4 saniye gibi.

Gerçek Kullanım Senaryoları

Domain Reseller API'nin kullanım alanları yalnızca hosting ve ajanslarla sınırlı değil. Aşağıdaki ekosistemde domain satışı ve yönetimi doğal bir gereksinim olarak ortaya çıkar:

Müşteri Yolculuğu: Tek API ile Tam Döngü

Müşteri example.com arıyor

↓ CheckAvailability API → Müsait

↓ Müşteri ödemeyi tamamlıyor

↓ RegisterWithContactInfo API → Domain kaydedildi

↓ ModifyNameServer API → DNS hosting sunucusuna yönlendi

↓ WHMCS otomatik SSL aktivasyon isteği açıyor

↓ Hosting account otomatik açıldı

↓ E-posta hosting API ile aktivasyonu tamamlandı

↓ Müşteri 10 dakikada example.com üzerinde canlı

Toplam manuel işlem: SIFIR

Senaryo 1: Hosting Firması Otomasyonu

Bir hosting firmasının müşterisi hosting paketi satın aldığında, sistem aynı anda domain kaydı da başlatabilir. WHMCS entegrasyonunda bu akış tamamen otomatiktir: müşteri ödemeyi tamamlar, WHMCS Domain Name API'ye kayıt isteği gönderir, domain aktif olur ve nameserver'lar hosting sunucusuna işaret edecek şekilde ayarlanır.

Senaryo 2: SaaS Platformu İçin Otomatik Domain Provisioning

"Kendi domain'inle kullan" özelliği sunan bir SaaS platformu hayal edin. Müşteri panelden kendi domain adını girer, platform Domain Name API üzerinden müsaitliği kontrol eder, müşteri satın alma onayı verir, API domain'i kaydeder ve DNS'i SaaS altyapısına yönlendirir. Bu akışın tamamı insan müdahalesi olmadan saniyeler içinde tamamlanabilir.

Senaryo 3: AI Startup için Bulk Domain Rezervasyonu

Bir AI girişiminin ürünü için 50 farklı TLD'de domain güvence altına alması gerekiyor: example.com, example.ai, example.io, example.co ve benzerleri. Bulk check API ile tüm müsaitlik sorgusu tek bir request'te yapılır. Müsait olanlar hemen kayıt edilir, müsait olmayanlar için alternatif önerileri sistem otomatik üretir.

Senaryo 4: Web Ajansı İçin White Label Bayi Sistemi

Bir web ajansı, kendi müşterilerine domain satışı yapabilmek için Domain Name API hesabı açar. Kendi panelinde müşterileri sadece ajansın markaladığı arayüzü görür. Ajans kendi marjını belirler, Domain Name API faturayı toptan fiyat üzerinden keser. Müşteriler domain'lerini ajans üzerinden yeniler; ajans her yenileme işleminden pasif gelir elde eder.

Senaryo 5: MSP İçin Merkezi Domain Portföy Yönetimi

Yüzlerce müşterinin domain'ini yöneten bir Managed Service Provider (MSP), her domain'in sona erme tarihini manuel takip etmek yerine API üzerinden otomatik bir yenileme hatırlatıcısı ve sona erme izleme sistemi kurar. Sona ermeye 60 gün kalan domain'ler otomatik yenileme kuyruğuna alınır; belirli bir eşiğin altına düşen bakiye için otomatik uyarı tetiklenir.

En Sık Yapılan Hatalar

OT&E testini atlamak: "Production'da da aynı çalışır" varsayımıyla production'a doğrudan geçmek; hatalı flow'lar gerçek domain kayıtlarına ve ücretlere neden olur.

Production ve OT&E kimlik bilgilerini karıştırmak: OT&E API Key ile production'a bağlanmaya çalışmak 401 hatası verir; karşı yönü ise gerçek işlem oluşturur.

Rate limit'i görmezden gelmek: Bulk check'i tek tek sorgu olarak yazmak ve kısa sürede yüzlerce istek göndermek hem hesabı bloke edebilir hem de entegrasyonu yavaşlatır.

API Key'i frontend'e gömmek: JavaScript dosyasında veya mobil uygulama bundle'ında açık API Key bulunması ciddi güvenlik riskidir.

Transfer öncesi Lock durumunu kontrol etmemek: Domain'de Transfer Lock aktifse transfer isteği reddedilir; müşteri deneyimi bozulur.

Admin contact e-postasını doğrulamamak: Transfer onay e-postası ulaşmazsa transfer askıda kalır ve 5 iş günü sonra otomatik iptal olur.

Redemption Grace Period'ı kaçırmak: Silinmiş bir domain'i restore etmek için kalan süreyi takip etmemek; pencere kapandıktan sonra domain başkası tarafından kayıt edilebilir.

DNS değişikliklerini propagation süresi gözetmeksizin test etmek: DNS değişiklikleri anlık geçerli olmaz; TTL değerine bağlı olarak 24-48 saat sürebilir.

Performans Önerileri

Müsaitlik sonuçlarını cache'leyin: Aynı domain için art arda gelen availability sorgularını önlemek için sonuçları kısa süreli (60-120 saniye) cache'de tutun.

Bulk check kullanın: Birden fazla domain için ayrı ayrı istek yerine dizi parametresiyle tek bulk request gönderin.

Async/queue mimarisine geçin: Yoğun domain operasyonlarını (büyük transfer batch'leri, toplu kayıtlar) asenkron bir kuyruğa alın; kullanıcıya anlık geri bildirim verin, arka planda işlemi tamamlayın.

Webhook / callback kullanın: Transfer veya domain aktivasyon sonuçlarını polling yerine API'nin callback mekanizmasıyla alın; bu hem sunucuyu yormaz hem de gecikmeyi azaltır.

IP Whitelist aktif tutun: Sadece güvenlik için değil, performans için de: whitelist dışı istekler 403 ile reddedilerek gereksiz API çağrısına dönüşmez.

Hata loglarını izleyin: 4xx ve 5xx hataları production'da gerçek zamanlı izleyin; özellikle 429 hatalarının ani artışı rate limit ayarlamaya veya request pattern optimizasyonuna işaret eder.

Sık Sorulan Sorular

Domain Reseller API nedir?

Domain Reseller API, bir domain Registrar veya Registrar altyapısı sunan platform tarafından sağlanan, domain kayıt, transfer, yenileme ve DNS yönetimi gibi operasyonları programatik olarak gerçekleştirmenizi sağlayan bir arayüzdür.

ICANN akreditasyonu olmadan domain satabilir miyim?

Evet. Bir Reseller olarak ICANN akreditasyonuna ihtiyacınız yok. Domain Name API gibi ICANN akrediteli bir platformun altyapısını kullanarak kendi markanız altında domain satışı yapabilirsiniz.

Registry, Registrar ve Reseller arasındaki fark nedir?

Registry belirli bir TLD'nin veritabanını yönetir; Registrar ICANN akrediteli olup Registry ile doğrudan entegrasyona sahiptir; Reseller ise Registrar altyapısını kullanarak son kullanıcıya domain satar.

REST API mi SOAP mı kullanmalıyım?

REST API kullanın. SOAP eski, verbose ve yönetimi zor bir protokoldür. Domain Name API'nin REST API'si JSON formatında çalışır, Swagger arayüzüyle test edilebilir ve modern geliştirme süreçlerine uyumludur.

OT&E ortamı nedir?

OT&E (Operational Test & Evaluation), gerçek domain kaydı veya ücret oluşturmadan API entegrasyonunuzu test etmenizi sağlayan izole bir test ortamıdır. Production'a geçmeden önce tüm akışlarınızı burada doğrulamanız önerilir.

OT&E ve production için farklı kimlik bilgileri gerekiyor mu?

Evet. Her iki ortam için ayrı Reseller ID ve API Key'e ihtiyacınız var. Bu bilgilerin her ikisi de reseller panelinizin entegrasyon bölümünde görüntülenebilir.

Domain Name API'ye kayıt ücreti var mı?

Hayır. Domain Name API'ye kayıt ücretsiz, ön ödeme zorunlu değil ve minimum bakiye şartı yok.

Kaç TLD destekleniyor?

2026 itibarıyla 800'den fazla TLD destekleniyor.

Hangi ödeme yöntemleri kabul ediliyor?

Kredi kartı, banka havalesi, PayPal, Stripe ve Alipay kabul ediliyor.

WHMCS entegrasyonu için modül ücretsiz mi?

Evet, Domain Name API'nin WHMCS modülü ücretsiz olarak sunuluyor ve GitHub üzerinden erişilebilir.

WiseCP, HostBill, Blesta ve ClientExec entegrasyonları var mı?

Evet. Domain Name API, bu platformların tamamı için modül desteği sunuyor. Bu, rakip platformların çoğunda mevcut olmayan bir özellik.

API Key'i nerede bulabilirim?

Reseller panelinize (dm.apiname.com) giriş yaptıktan sonra entegrasyon bölümünden hem Production hem OT&E kimlik bilgilerinizi görebilirsiniz.

API kimlik doğrulamasında kullanıcı adı ve şifre kullanılıyor mu?

Hayır. REST API'de kullanıcı adı/şifre yerine Reseller ID ve API Key kombinasyonu kullanılır.

Rate limit nedir ve nasıl yönetilir?

Rate limit, belirli bir sürede göndereceğiniz istek sayısını sınırlandıran bir mekanizmadır. Aşılması durumunda 429 hatası döner. Exponential backoff ve bulk request kullanımı bu limiti yönetmenin temel yollarıdır.

Bulk domain sorgusu yapabilir miyim?

Evet. Domain müsaitlik sorgusunda birden fazla domain'i tek bir request body'de dizi olarak gönderebilirsiniz.

Premium domain kaydında ekstra maliyet var mı?

Evet. Premium domain'lerin Registry tarafından belirlenen özel bir fiyatı var ve bu fiyat standart kayıt ücretinin çok üzerinde olabilir. Availability check yanıtı premium durumu ve fiyatı döndürür.

Transfer için gerekli koşullar nelerdir?

Domain'in Transfer Lock'unun kaldırılmış olması, son 60 gün içinde kayıt veya transfer edilmemiş olması ve geçerli bir EPP/Auth Code'un olması gerekir.

Restore işlemi nedir ve ne zaman yapılabilir?

Restore, silinmiş bir domain'i Redemption Grace Period (genellikle 30 gün) içinde ek ücret karşılığında kurtarma işlemidir. Bu süre dolduktan sonra domain başkasına açılabilir.

WHOIS ve RDAP arasındaki fark nedir?

WHOIS eski bir protokoldür; RDAP ise HTTPS üzerinden JSON formatında yanıt veren, ICANN destekli modern halefidir. API entegrasyonlarında RDAP tercih edilmelidir.

DNS kayıtlarını API üzerinden yönetebilir miyim?

Evet. A, AAAA, CNAME, MX, TXT, NS, SRV ve CAA gibi kayıt tiplerini API üzerinden ekleyip düzenleyebilirsiniz.

DNSSEC API üzerinden aktif edilebilir mi?

Evet. DNSSEC aktivasyonu için DS kaydının API üzerinden Registry'e iletilmesi gerekir.

Glue Record nedir ve ne zaman kullanılır?

Kendi domain'iniz üzerinde nameserver tanımladığınızda döngüsel bir bağımlılık oluşur. Bu durumu çözmek için Registry'e nameserver'ın IP adresini doğrudan bildiren Glue Record tanımlanır.

White label nedir?

Arka planda Domain Name API altyapısını kullanırken müşterilerinizin yalnızca kendi markanızı görmesini sağlayan bir yapıdır.

Sub-reseller sistemi nasıl çalışır?

Kendi reseller hesabınız altında başka bayilere alt hesaplar tanımlayabilirsiniz. Her bayinin fiyatını, kotasını ve API erişimini merkezi olarak yönetebilirsiniz.

PHP ile nasıl entegre olabilirim?

Domain Name API REST tabanlıdır; PHP'nin curl veya Guzzle kütüphanesiyle HTTPS POST isteği göndermeniz yeterlidir.

Python entegrasyonu mümkün mü?

Evet. Python'da requests kütüphanesiyle birkaç satır kodla REST API'ye bağlanabilirsiniz.

Node.js entegrasyonu için ne gerekli?

node-fetch veya axios gibi HTTP client kütüphanesiyle JSON body göndererek entegrasyon kurabilirsiniz.

.NET ile entegrasyon nasıl yapılır?

C# ve .NET'in HttpClient sınıfıyla JSON serialize edip POST isteği göndermeniz yeterlidir. .NET API desteği de mevcut.

API Key'i güvende tutmak için ne yapmalıyım?

API Key'i sadece backend kodunda tutun, frontend'e gömmeyin. IP whitelist aktif edin ve Key'i periyodik olarak rotasyona alın.

Domain portföyümü başka bir registrar'dan nasıl taşıyabilirim?

Domain listesini dışa aktarın, Auth Code'ları alın, Transfer Lock'ları kaldırın ve Domain Name API destek ekibiyle koordineli olarak toplu transfer başlatın.

Domain Name API ICANN akrediteli mi?

Evet.

Fiyatlandırma kademeleri nasıl çalışıyor?

Reseller, Premium, Platinum ve VIP olmak üzere dört kademe var. Satış hacmine ve programa bağlı olarak toptan fiyatlar düşüyor.

Domain Name API'nin rakiplerine göre farkı nedir?

850+ TLD desteği, ücretsiz başlangıç, WHMCS/WiseCP/HostBill/Blesta/ClientExec entegrasyonu, sub-reseller sistemi, REST API ve 40.000+ aktif reseller ile rakiplerinin çoğunun sunmadığı bir kombinasyon sunuyor.

Destek kanalları nelerdir?

Telefon (+90 262 325 07 76), live chat ve ticket sistemi üzerinden destek alınabilir.

OT&E üzerinde gerçekten sınırsız test yapabilir miyim?

OT&E ortamındaki işlemler gerçek kayıt veya ücret oluşturmaz; entegrasyonunuzu ve edge case'leri özgürce test edebilirsiniz.

Domain Growth Program nedir?

Domain Name API'ye özgü bir bayi büyüme programıdır; rakip platformlarda bu program mevcut değildir. Satış hacminize göre ek avantajlar ve fiyat indirimleri sağlar.