Bir müşterinin sabahın 2:30'unda bir domain satın aldığını düşünün. Beklediği şey, ofise birinin gelmesini bekleyen bir destek talebi değil, domainin hemen aktif olmasıdır. Hosting sağlayıcıları, SaaS platformları ve domain bayileri için bu beklenti, otomasyonu "olsa iyi olur" olmaktan çıkarıp temel bir gereklilik haline getiriyor.

Domain Reseller API tam olarak bunu sağlar: platformunuzun bir domain registrar sistemiyle doğrudan konuşmasına imkân tanır. Bir personelin domain kaydetmek için kontrol paneline giriş yapması gerekmez; yazılımınız bir istek gönderir ve saniyeler içinde onaylanmış bir sonuç alır. Hosting şirketleri ve bayilerle çalışırken edindiğimiz tecrübeye göre, kayıt, transfer ve yenileme işlemlerini erken otomatikleştiren işletmeler, destek ekibini aynı oranda büyütmek zorunda kalmadan sipariş hacmini artırabiliyor. Bu yazıda Domain Reseller API'nin ne olduğunu, nasıl çalıştığını, bir API seçerken nelere dikkat etmeniz gerektiğini ve çoğu entegrasyon projesini yavaşlatan hataları ele alıyoruz.

Domain Reseller API Nedir?

Kısa Cevap

Domain Reseller API, bir işletmenin registrar kontrol panelinde manuel işlem yapmadan domain kaydetmesini, yenilemesini, transfer etmesini ve yönetmesini sağlayan bir arayüzdür. Web sitenizi, faturalandırma sisteminizi veya hosting platformunuzu doğrudan bir domain registrarın arka uç altyapısına bağlar.

Açıklama

API'yi sunan şirket genellikle ICANN akredite bir registrar'dır ya da böyle bir registrar ile yakın çalışır. Bayi olarak, kendinizin akredite bir registrar olmanıza gerek yoktur. Registrar'ın Domain Registrar API'sini kendi markanız altında kullanır, kendi fiyatlarınızı belirler ve kendi müşterilerinizi yönetirsiniz; ICANN ve her domain registry ile olan teknik ilişkiyi registrar üstlenir.

Aynı teknolojinin White Label Domain API olarak da anılmasının nedeni budur. Müşterileriniz sizin markanızı ve fiyatlandırmanızı görür. Perde arkasında çalışan kayıt, DNS ve transfer mantığı ise API sağlayıcısına aittir.

Örnek

Bir web ajansı kendi sitesine bir domain arama kutusu ekler. Bir ziyaretçi bir isim aratıp satın aldığında, ajansın arka planı Domain Registration API'yi çağırır, domain arka planda kaydedilir ve ziyaretçi işlemi hangi registrar'ın gerçekleştirdiğini ne görür ne de bilir.

Domain Reseller API Nasıl Çalışır?

Bir Domain Reseller API, basit bir istek-yanıt döngüsü üzerinden çalışır. Uygulamanız "bu müşteri için şu domaini kaydet" gibi yapılandırılmış bir istek gönderir, API de sonucu onaylayan yapılandırılmış bir yanıt döndürür.

Her istek genellikle şunları içerir:

• Reseller ID ve API Key gibi kimlik doğrulama bilgileri
• Domain adı ve uzantısı (TLD)
• Registrant, idari, teknik ve fatura iletişim bilgileri
• Kayıt süresi ve gerekiyorsa name server bilgileri

Perde arkasında, registrar'ın sistemi domain registry ile EPP (Extensible Provisioning Protocol) üzerinden iletişim kurar; bu protokol, domain sektöründe kayıt, yenileme ve transfer işlemleri için endüstri standardıdır. Entegrasyonunuzun EPP ile doğrudan konuşmasına gerek yoktur. Domain Registration API isteğinizi doğru registry komutlarına çevirir ve size temiz, okunabilir bir yanıt döndürür. Bu tür bir REST arayüzü genellikle Swagger üzerinden eksiksiz belgelenir; bu yüzden çoğu geliştirici OT&E ortamında ilk saatinde çalışan bir test isteği gönderebilir.

İstek Akışı Bir Bakışta

Tek bir isteğin, müşterinin ekranından onaylanmış bir domaine kadar izlediği yol şöyledir:

• Müşteri
• v
• Web Sitesi / WHMCS / WISECP
• v
• Domain Name API REST API
• v
• Registrar Platformu
• v
• Registry (EPP)
• v
• DNS + WHOIS
• v
• Başarılı Yanıt

Domain Kayıt Süreci

API üzerinden tipik bir domain kaydı dört adımda gerçekleşir.

Müsaitlik kontrolü: API, domainin kayıt için müsait olup olmadığını registry üzerinden sorgular.

Kayıt gönderimi: sisteminiz domain adını, kayıt süresini, name server bilgilerini ve iletişim bilgilerini gönderir.

Registry işlemesi: istek EPP üzerinden registry'e iletilir; tüm veriler geçerliyse domain oluşturulur.

Onay: API, son kullanma tarihi ve domain durumu ile birlikte kaydı onaylayan bir yanıt döndürür.

Çoğu sağlayıcı standart uzantılarda bu onayı bir saniyenin çok altında bir sürede döndürür; hosting veya SaaS sitelerinde gerçek zamanlı domain satın alma akışını mümkün kılan da budur. İyi kurgulanmış bir REST API'de bu dizi, 750'den fazla desteklenen uzantı için tek bir müsaitlik çağrısı ve tek bir kayıt çağrısına indirgenir; yani bir satın alma akışı nadiren iki istekten fazlasına ihtiyaç duyar.

Kendi kayıt akışınızın kaç istekte tamamlandığını görmek isterseniz, OT&E hesabınızla birkaç test isteği göndermek genellikle yeterli bir başlangıç noktasıdır.

Domain Transfer Süreci

Bir domainin transfer edilmesi, mevcut kayıt geçmişi ve son kullanma tarihi korunarak domainin bir registrar'dan diğerine taşınması anlamına gelir. Domain Transfer API, manuel form gönderimleri yerine bu süreci otomatikleştirir.

Müşteri, kaybeden registrar tarafından verilen güvenlik anahtarı olan domainin Auth Code'unu (EPP kodu olarak da bilinir) sağlar.

Sisteminiz, Auth Code ve güncellenmiş iletişim bilgileriyle birlikte API üzerinden bir transfer isteği gönderir.

Kaybeden registrar veya registrant transferi onaylar; onaylanmazsa, işlem herhangi bir aksiyon alınmadan standart bekleme süresinin ardından otomatik olarak devam eder.

Onaylandıktan sonra registry, domainin kayıtlı registrar'ını günceller ve API tamamlanan transferi onaylar.

Bir müşterinin platformunuzdan başka bir registrar'a geçtiği outbound transferler de aynı şekilde, tersine işler. Eksiksiz bir Domain Registrar API her iki yönü de destekler. Sağlayıcı ayrıca ICANN politikasının gerektirdiği durumlarda contact verification işlemini otomatik olarak tetikler; böylece registrant e-postaları manuel bir takip adımı olmaktan çıkıp transfer sürecinin doğal bir parçası olur. Bayilerin burada yaptığı en yaygın hatalardan biri, transferlerin OT&E gibi test ortamlarının bazılarında desteklenmediğini unutmaktır; bu yüzden transfer mantığının canlıya çıkmadan önce küçük bir production doğrulaması gerekir.

Domain Yenileme Süreci

Yenilemeler genellikle bir bayi platformundaki en yüksek hacimli işlemdir; bu da onları otomasyon için en uygun aday haline getirir.

API, portföyünüzdeki domainlerin yaklaşan son kullanma tarihlerini kontrol eder.

Son kullanma tarihinden önce, manuel olarak tetiklenen ya da otomatik olarak zamanlanan bir yenileme isteği gönderilir.

Registry kayıt süresini uzatır ve yeni son kullanma tarihini döndürür.

Faturalandırma sisteminiz bu adımı fatura ödemesine bağlı olarak otomatik tetikleyebilir; böylece manuel yenileme takibine gerek kalmaz.

Faturalandırma platformunuza bağlı bir Domain Renewal API, bayilerin en sık yaptığı ve en yıkıcı hatalardan birini önleyebilir: manuel bir yenileme adımı atlandığı için müşterinin domaininin süresinin dolup düşmesi. Tecrübemize göre, bir domaini süresi dolduğu için kaybeden bayilerin çoğu dikkatsiz değildi; sadece son kullanma tarihlerini kontrol eden otomatik bir sistemleri yoktu.

Yenileme akışınızı canlıya almadan önce OT&E ortamında birkaç senaryoyla (zamanında ödeme, gecikmiş ödeme, başarısız ödeme) test etmeniz, ilk ayda karşılaşabileceğiniz sürprizlerin çoğunu ortadan kaldırır.

Bir Domain API'sinde Bulunması Gereken Temel Özellikler

Her Domain Registrar API aynı derinlikte işlevsellik sunmaz. Tecrübemize göre bu eksikler genellikle aylar sonra, hacim büyüyüp uç durumlar ortaya çıktığında fark ediliyor. Entegrasyona başlamadan önce sağlayıcının aşağıdaki alanları kapsadığından emin olun.

Domain Müsaitliği

Premium ve kısıtlı uzantılar dahil gerçek zamanlı müsaitlik kontrolleri, böylece müşteriler arama anında doğru sonuçlar görür. Kapsamlı bir sağlayıcı bunu 750'den fazla uzantıda tek bir REST çağrısıyla sunar.

Kayıt

Standart jenerik TLD'ler ve ülke kodlu TLD'ler için destek, esnek kayıt süreleri ve çok sayıda domaini aynı anda yöneten ajanslar için toplu kayıt.

Yenileme

Otomatik ve manuel yenileme seçenekleri, yaklaşan son kullanma tarihlerine görünürlük; böylece hiçbir domain geç kalmaz veya atlanmaz.

Transfer

Inbound ve outbound transfer desteği, Auth Code yönetimi ve transfer penceresi boyunca durum takibi.

İletişim Bilgisi Yönetimi

Birden fazla domain üzerinde registrant, idari, teknik ve fatura iletişim bilgilerini oluşturma, güncelleme ve yeniden kullanma yeteneği; ICANN politikasının gerektirdiği durumlarda otomatik contact verification dahil.

Nameserver Yönetimi

Bir domainin name server'ları üzerinde programatik kontrol; bu, domainleri kendi altyapılarına yönlendiren hosting şirketleri için kritik önemdedir.

DNS Yönetimi

A, MX, CNAME ve TXT kayıtları gibi DNS kayıtlarını ayrı bir kontrol paneli yerine doğrudan API üzerinden yönetme seçeneği.

WHOIS Gizliliği

Registry ve uzantının izin verdiği durumlarda, registrant iletişim bilgilerini genel WHOIS ve RDAP sorgularının dışında tutan otomatik WHOIS gizlilik koruması.

Premium Domainler

Premium domain fiyatlandırması ve kaydı için destek; bu domainler genellikle standart fiyatlı isimlerden farklı bir işlem gerektirir.

Domain Yaşam Döngüsü Yönetimi

Kayıttan yenilemeye, süre bitiminden redemption sürecine ve gerektiğinde silinmesine kadar bir domainin yaşamının her aşamasına görünürlük. Çoğu bayi bunu ancak bir müşterinin domaini beklenmedik şekilde grace veya redemption sürecine girdiğinde düşünmeye başlıyor; bu yüzden tüm süreci tek bakışta görmek işe yarıyor.

Domain Yaşam Döngüsüne Bir Bakış

Bir domain sadece var ya da yok değildir. Kayıt ile yenileme veya süre bitimi arasında tanımlı bir durum dizisinden geçer; yetenekli bir Domain Reseller API her aşamaya görünürlük sağlar.

Müsait
v
Kayıtlı --> Aktif
v
Yenileme Zamanı
v
Süresi Doldu
v
Grace Period
v
Redemption
v
Silinmeyi Bekliyor
v
Tekrar Müsait

Yenilenmeyen bir domain hemen ortadan kaybolmaz. Genellikle önce bir grace period'dan, ardından daha yüksek bir maliyetle geri alınabildiği bir redemption period'dan geçer ve ancak bundan sonra müsait isimler havuzuna geri döner. Bu diziyi anlamak, endişeli bir müşteriyi geç kalmış bir yenileme konusunda yönlendirebilen bir bayi ile "emin değilim" demek zorunda kalan bir bayi arasındaki farkı yaratır.

ICANN Registrar Olmak Yerine Neden Domain Reseller API Kullanılır?

Bu, domain hacmi doğrudan yönetmeye değecek noktaya geldiğinde büyüyen bir hosting şirketinin veya ajansın sorduğu ilk sorulardan biridir. ICANN akredite bir registrar olmak teknik olarak her işletme için mümkündür, ancak hosting, SaaS veya ajans hizmetlerinin yanında domain satmak isteyen bir şirket için nadiren doğru tercihtir.

Çoğu hosting şirketi, bayi ve ajans için doğrudan akreditasyonun ekonomik olarak anlamlı olması, çoğu işletmenin ulaşamadığı bir hacme ulaşıldığında başlar. O noktaya kadar bir Domain Reseller API, uyumluluk ve altyapı yükü olmadan aynı müşteriye yönelik işlevselliği kendi markanız altında sunar. Örneğin Domain Name API, bu altyapıyı 20+ yıl içinde inşa etmiş ve şu anda 200'den fazla ülkede 40.000'den fazla bayiye hizmet veriyor; bu ölçek, bağımsız olarak yeniden oluşturulması zor bir ölçek.

Manuel Domain Yönetimi ile API Otomasyonu Karşılaştırması

Manuel domain yönetimi ile API otomasyonu arasındaki fark, işlem hacmi büyüdükçe netleşir.

REST API ile SOAP API Karşılaştırması

Kısa cevap: REST API, JSON tabanlı, hafif ve kurulumu hızlı olduğu için yeni domain entegrasyonlarında SOAP'a göre neredeyse her zaman tercih edilir; SOAP ise yalnızca eski sistemlerle uyumluluk gerektiğinde anlamlıdır.

Domain registrar'lar tarihsel olarak hem REST hem de SOAP arayüzleri sunmuştur. Modern platformların çoğu artık REST'i önceliklendiriyor; çünkü REST daha hafif, test etmesi daha kolay ve modern programlama dilleriyle daha uyumlu.

2026'da yeni bir entegrasyona başlıyorsanız, bir REST Domain Registration API neredeyse her zaman doğru varsayılan seçimdir. SOAP, yalnızca mevcut bir eski sistem buna zaten bağımlıysa değerlendirilmeye değer.

Test Ortamı ile Production Ortamı Karşılaştırması

Herhangi bir canlı müşteri verisine bağlanmadan önce, ciddi her API sağlayıcısı genellikle OT&E (Operational Test and Evaluation) olarak adlandırılan bir sandbox sunar. Bu, gerçek kayıt, yenileme veya ödeme işlemesi yapmadan production işlevselliğini yansıtan ayrı bir sistemdir. Domain Name API her iki arayüzü de Swagger üzerinden yayınlar; production api.domainresellerapi.com adresinde, OT&E ise ote.domainresellerapi.com adresinde yer alır. Böylece geliştiriciler tek bir entegrasyon satırı yazmadan önce her endpoint'i inceleyebilir.

Uygun bir test ortamı, ekibinizin kimlik doğrulamayı, kayıt akışlarını, hata yönetimini ve süresi dolmuş domainler ya da geçersiz iletişim verisi gibi uç durumları finansal risk almadan doğrulamasını sağlar. Test tamamlandıktan sonra, çoğu sağlayıcı bir test hesabını, entegrasyonu yeniden kurmanıza gerek kalmadan production hesabına dönüştürür; çünkü API yapısı iki ortam arasında aynıdır.

Bu adımı atlamak, production kesintilerinin en yaygın nedenlerinden biridir. Sadece başarılı senaryoları değil, hata senaryolarını da test edin; çünkü gerçek dünyadaki destek taleplerinin büyük bir kısmı mutlu yoldan değil, ele alınmamış uç durumlardan kaynaklanır.

API Güvenliği ve Güvenilirliği

Bir Domain Reseller API faturalandırma ve müşteri verinize yakın çalışır; bu yüzden güvenlik ve güvenilirlik isteğe bağlı ayrıntılar değildir.

API Kimlik Doğrulama

Erişim genellikle kullanıcı adı ve parola yerine bir Reseller ID ve API Key üzerinden kontrol edilir; bu da farklı sistemler arasında kimlik bilgisi tekrar kullanımı riskini azaltır.

IP Whitelist

API erişimini onaylı sunucu IP adresleriyle sınırlamak, API anahtarının kendisinin ötesinde ikinci bir koruma katmanı ekler. İyi bir reseller paneli, IP whitelist'i doğrudan panelden yapılandırmanıza izin verir; böylece production trafiği yalnızca sizin kontrolünüzdeki sunuculardan kabul edilir.

API Key'ler

Anahtarlar sunucu tarafında güvenli şekilde saklanmalı, düzenli olarak yenilenmeli ve asla istemci tarafı kodda veya herkese açık depolarda paylaşılmamalıdır.

Rate Limit

Sağlayıcılar altyapı istikrarını korumak için rate limit uygular. Entegrasyonunuz yayınlanan limitlere uymalı ve throttling yanıtlarını hemen yeniden denemek yerine zarifçe ele almalıdır.

Loglama

Her isteğin ve yanıtın kaydını tutmak, sonradan başarısız bir kayıt veya transferi teşhis etmeyi çok daha kolay hale getirir.

Retry Logic

Ağ sorunları ve zaman aşımları olur. İyi kurgulanmış bir entegrasyon, sessizce başarısız olmak veya siparişi tekrarlamak yerine, kısa bir gecikmeyle başarısız istekleri yeniden dener.

Hata Yönetimi

Sisteminiz başarıyı varsaymadan önce her yanıt hata kodları açısından kontrol edilmelidir. En yaygın hatalardan biri, registry kaydı henüz onaylamadan önce checkout akışının müşteriye "Sipariş Onaylandı" göstermesidir.

Bu kontrol listesini kendi entegrasyonunuzla karşılaştırmak isterseniz, OT&E ortamında birkaç hatalı senaryo (geçersiz iletişim verisi, zaman aşımı, yetersiz bakiye) simüle etmek genellikle gözden kaçan noktaları hızlıca ortaya çıkarır.

Domain API Entegrasyon Seçenekleri

Bir Domain Reseller API'yi entegre etmenin tek doğru yolu yoktur. Doğru seçenek mevcut teknoloji yığınınıza bağlıdır.

Özel entegrasyon: geliştiriciler Domain Name API'nin REST API'sine doğrudan bağlanır, kullanıcı deneyimi ve iş akışı üzerinde tam kontrol sağlar.

WHMCS: yaygın olarak kullanılan bir hosting ve faturalandırma platformu. WHMCS kullanıcıları Domain Name API'nin ücretsiz WHMCS modülünü kurarak özel geliştirme yapmadan kayıt, yenileme ve transfer otomasyonu elde edebilir.

WISECP: Domain Name API'nin ücretsiz WISECP modülü aracılığıyla domain ve SSL yönetimi için yerel destek sunan modern bir faturalandırma ve otomasyon paneli.

Hosting platformları: kontrol panelleri API'ye bağlanabilir; böylece domain satın alımları hosting siparişleriyle birlikte gerçekleşir.

Faturalandırma sistemleri: HostBill, Blesta ve ClientExec gibi platformlar aynı altta yatan API'ye bağlanan domain modüllerini destekler.

Web sitesi oluşturucular: bazı web sitesi ve sayfa oluşturucu platformlar, domain arama ve kaydını doğrudan kayıt akışına entegre eder.

Zaten WHMCS veya benzer bir platform çalıştıran hosting şirketleri için, bir WHMCS Domain API modülü genellikle otomasyona giden en hızlı yoldur; çünkü özel geliştirmeye gerek kalmaz. Mevcut yığınınıza en uygun seçeneği netleştirmek için, hangi platformu kullandığınızı test hesabınızın kurulumu sırasında belirtmeniz genellikle yeterlidir.

Sık Yapılan Entegrasyon Hataları

Çoğu entegrasyon sorunu, önlenebilir küçük bir hata grubundan kaynaklanır. Birçok hosting sağlayıcısı ilk production ayında aynı birkaç soruna takılıyor.

Sandbox testi yapmadan canlıya çıkmak: OT&E ortamını atlamak, ilk gerçek hataların ödeme yapan müşterilerin önünde yaşanması anlamına gelir.

Hata yanıtlarını görmezden gelmek: her API çağrısını yanıt kodunu kontrol etmeden başarılı saymak, sessiz hatalara yol açar.

API key'leri istemci tarafı kodda sabit kodlamak: bu, kimlik bilgilerini sitenin kaynak kodunu inceleyen herkese açık hale getirir.

Zaman aşımları için retry logic olmaması: tek bir ağ kesintisi, başarısız bir kayıt sanılabilir ve mükerrer siparişlere veya destek taleplerine yol açabilir.

Yenileme otomasyonunun eksik olması: kaydı bağlayıp yenilemeyi bağlamamak, en yüksek hacimli iş akışını manuel bırakır.

Gönderim öncesi iletişim verisini doğrulamamak: registry'ler hatalı iletişim bilgilerini reddeder; bunu erken yakalamak checkout'ta başarısız siparişleri önler.

Domain Otomasyonunun İş Faydaları

Domain işlemlerini otomatikleştirmek, bir bayi veya hosting işinin ekonomisini değiştirir. Tecrübemize göre, en erken otomatikleştiren işletmeler, destek taleplerinde orantılı bir artış olmadan sipariş hacmini ölçeklendirebiliyor.

Daha hızlı kayıt: domainler manuel incelemeyi beklemek yerine saniyeler içinde aktif olur.

Daha düşük operasyonel iş yükü: personel zamanı tekrarlayan veri girişinden müşteri desteği ve büyümeye kayar.

Daha az manuel hata: doğrulanmış API istekleri, manuel girişte sık görülen yazım hatalarını ve uyumsuz iletişim verilerini azaltır.

Daha iyi müşteri deneyimi: anlık onay ve self-servis transfer veya yenileme, müşteride güven oluşturur.

Daha kolay ölçeklenme: sipariş hacmindeki büyüme, destek kadrosunda orantılı bir büyüme gerektirmez.

White-label satış: API registry düzeyindeki işlemleri yürütürken markanız müşterinin önünde kalır.

7/24 otomasyon: kayıt, yenileme ve transfer işlemleri, kimse nöbette olmadan mesai saatleri dışında da tamamlanabilir.

Neden Domain Name API Kullanılmalı?

Domain Name API, Swagger üzerinden eksiksiz belgelenen REST tabanlı bir Domain Reseller API üzerinden 750'den fazla domain uzantısını destekler; canlıya çıkmadan önce sandbox testi için özel bir OT&E test platformu sunar. Altyapı white-label domain bayilik operasyonları için tasarlanmıştır; 20+ yıllık tecrübeyle 200'den fazla ülkede 40.000'den fazla bayiye hizmet vermektedir. Bayiler, kendi geliştirme sürecini kurmak istemeyen ekipler için ücretsiz WHMCS ve WISECP modülleriyle domainleri kendi markaları altında kaydedebilir, transfer edebilir ve yenileyebilir.

Teknik Örnekler

Aşağıdaki örnekler, production için api.domainresellerapi.com ve OT&E sandbox için ote.domainresellerapi.com adreslerinde bulunan Domain Name API Swagger arayüzünde yayınlanan REST yapısını izler. Her çağrı kullanıcı adı ve parola yerine bir Reseller ID ve API Key ile kimlik doğrular.

Not: aşağıda gösterilen örnek istekler eğitim amaçlı basitleştirilmiş örneklerdir. Bunları temel alarak geliştirme yapmadan önce güncel endpoint'ler, gerekli parametreler ve desteklenen işlemler için en güncel Swagger dokümantasyonuna başvurun.

Müsaitlik Kontrolü İsteği

POST https://api.domainresellerapi.com/v1/domain/check
Content-Type: application/json
{
"resellerId": "YOUR_RESELLER_ID",
"apiKey": "YOUR_API_KEY",
"domainName": "example.com"
}

Kayıt İsteği Örneği

POST https://api.domainresellerapi.com/v1/domain/register
Content-Type: application/json
{
"resellerId": "YOUR_RESELLER_ID",
"apiKey": "YOUR_API_KEY",
"domainName": "example.com",
"period": 1,
"nameServers": [
"ns1.domainnameapi.com",
"ns2.domainnameapi.com"
],
"registrantContactId": "CNT-88214",
"whoisPrivacy": true
}

Yanıt Örneği

{
"status": "Success",
"domainName": "example.com",
"expiryDate": "2027-07-11",
"orderId": "ORD-551029"
}

Hata Yanıtı Örneği

{
"status": "Error",
"errorCode": "DOMAIN_NOT_AVAILABLE",
"message": "The requested domain is already registered."
}

Transfer İsteği Örneği

POST https://api.domainresellerapi.com/v1/domain/transfer
Content-Type: application/json
{
"resellerId": "YOUR_RESELLER_ID",
"apiKey": "YOUR_API_KEY",
"domainName": "example.com",
"authCode": "aB3-xY9-eppCode",
"registrantContactId": "CNT-88214"
}

Yenileme İsteği Örneği

POST https://api.domainresellerapi.com/v1/domain/renew
Content-Type: application/json
{
"resellerId": "YOUR_RESELLER_ID",
"apiKey": "YOUR_API_KEY",
"domainName": "example.com",
"period": 1,
"currentExpiryDate": "2027-07-11"
}

DNS Güncelleme İsteği Örneği

POST https://api.domainresellerapi.com/v1/domain/dns/update
Content-Type: application/json
{
"resellerId": "YOUR_RESELLER_ID",
"apiKey": "YOUR_API_KEY",
"domainName": "example.com",
"records": [
{ "type": "A", "host": "@", "value": "192.0.2.10", "ttl": 3600 },
{ "type": "MX", "host": "@", "value": "mail.example.com", "priority": 10 }
]
}

Retry Logic Örneği

attempts = 0
while attempts < 3:
response = call_api(
"https://api.domainresellerapi.com/v1/domain/register",
payload
)
if response.status == "Success":
break
if response.errorCode == "TIMEOUT":

attempts += 1

wait(2 * attempts)

else:

• break # ağ dışı hatalarda yeniden deneme yapma

Sık Sorulan Sorular

Domain Reseller API nedir?

Domain Reseller API, işletmelerin kendi yazılımları üzerinden bir registrar'ın arka uç altyapısını kullanarak domain kaydetmesini, yenilemesini, transfer etmesini ve yönetmesini sağlayan bir arayüzdür.

Domain Reseller API kullanmak için akredite bir registrar olmam gerekir mi?

Hayır. Bayi olarak, API sağlayıcısının ICANN akreditasyonunu ve registry ilişkilerini kullanırsınız. Kendinizin akredite bir registrar olmasına gerek yoktur.

ICANN registrar olmak mı yoksa Domain Reseller API kullanmak mı daha mantıklı?

Çoğu hosting şirketi, ajans ve SaaS platformu için Domain Reseller API kullanmak daha pratik bir seçimdir. Akredite bir registrar olmak; akreditasyon ücretleri, sürekli uyumluluk yükümlülükleri ve doğrudan registry sözleşmeleri gerektirir; bunlar ancak çoğu bayinin ulaşmadığı bir ölçekte anlamlı hale gelir.

Domain Registration API ile Domain Transfer API arasındaki fark nedir?

Domain Registration API yeni bir domain kaydı oluşturur. Domain Transfer API ise mevcut bir domaini bir registrar'dan diğerine taşır. Genellikle ikisi de aynı geniş API'nin parçasıdır.

Auth Code nedir?

Auth Code, EPP kodu olarak da bilinir; bir domainin mevcut registrar'ı tarafından verilen ve domainin yeni bir registrar'a transfer edilmesine izin veren güvenlik kodudur.

EPP nedir?

EPP, Extensible Provisioning Protocol'ün kısaltmasıdır. Registrar'ların kayıt, yenileme ve transfer işlemleri için domain registry'leriyle iletişim kurmak amacıyla kullandığı standart protokoldür.

WHOIS ile RDAP arasındaki fark nedir?

WHOIS, domain kayıt verilerini sorgulamak için kullanılan daha eski protokoldür. RDAP (Registration Data Access Protocol) ise birçok registry'nin artık WHOIS'in yanında ya da yerine kullandığı, daha yeni ve yapılandırılmış alternatiftir.

Yeni bir entegrasyon için REST API mi yoksa SOAP API mi seçmeliyim?

Yeni entegrasyonlar için genellikle REST daha iyi bir seçimdir; çünkü daha hafiftir, test etmesi daha kolaydır ve neredeyse her programlama diliyle uyumludur.

OT&E ortamı nedir?

OT&E, Operational Test and Evaluation'ın kısaltmasıdır. Gerçek kayıt veya ödeme işlemesi yapmadan production API'yi yansıtan, canlıya çıkmadan önce test için kullanılan bir sandbox ortamıdır.

Domain Reseller API'yi WHMCS ile entegre edebilir miyim?

Evet. Bir WHMCS Domain API modülü, özel geliştirmeye gerek kalmadan doğrudan WHMCS içinde otomatik kayıt, yenileme ve transfer yapılmasını sağlar.

White-label domain bayiliği nedir?

White-label domain bayiliği, teknik altyapıyı başka bir şirket sağlarken domain hizmetlerini kendi markanız altında satmanız anlamına gelir. Bu, müşterilerinizin sizin markanızı, fiyatlandırmanızı ve hizmet deneyiminizi görmesi, arka plandaki domain işlemlerinin ise bayilik platformu tarafından yürütülmesi demektir.

WHOIS gizliliği bir API üzerinden nasıl çalışır?

API, bir domain üzerinde WHOIS gizlilik korumasını açıp kapatabilir; bu da registry'nin izin verdiği durumlarda registrant iletişim bilgilerini genel WHOIS ve RDAP sorgularından gizler.

Bir domain yenilemesi API üzerinden başarısız olursa ne olur?

Doğru kurgulanmış bir entegrasyon net bir hata yanıtı döndürür; böylece faturalandırma sisteminiz domain son kullanma tarihine ulaşmadan önce yenilemeyi tekrar deneyebilir veya müşteriyi uyarabilir.

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

Evet, çoğu Domain Registrar API, A, MX ve CNAME kayıtları gibi DNS kayıtlarını kayıt için kullanılan aynı arayüz üzerinden oluşturmanıza ve güncellemenize izin verir.

Premium domain nedir?

Premium domainler, genellikle kısa, akılda kalıcı olmaları veya değerli anahtar kelimeler içermeleri nedeniyle registry ya da önceki sahibi tarafından standart oranların üzerinde fiyatlandırılan isimlerdir. Yetenekli bir API, bunların standart fiyatlı domainlerin yanında kaydedilmesini destekler.

Bir domain bayilik hesabıyla API erişimi ücretsiz mi?

API erişimi genellikle bayilik hesabına dahildir, ancak bu sağlayıcıya göre değişir. Domain ve hizmet fiyatlandırması kullanılan spesifik uzantılara ve hacme bağlıdır.

Domain Reseller API ile toptan (bulk) domain kaydı yapılabilir mi?

Evet. Çoğu Domain Registration API, tek bir istekte veya kısa bir döngüde onlarca hatta yüzlerce domainin kaydedilmesini destekler; bu özellikle çok sayıda domaini aynı anda yöneten ajanslar ve markalama amaçlı toplu kayıt yapan işletmeler için kullanışlıdır.

WHMCS Domain API modülü kurulumu ne kadar sürer?

Hazır bir WHMCS modülü kullanıldığında kurulum genellikle bir-iki saat içinde tamamlanır; bu süre Reseller ID ve API Key'in tanımlanması, OT&E üzerinde birkaç test siparişi verilmesi ve ardından production'a geçilmesini kapsar.

Domain Reseller API'nin sunduğu güvenlik önlemleri nelerdir?

Tipik güvenlik önlemleri arasında Reseller ID ve API Key ile kimlik doğrulama, IP whitelist, rate limit, tüm isteklerin loglanması ve ağ hatalarında otomatik retry logic bulunur.

Bir domain reseller platformu kaç günde canlıya alınabilir?

Hazır bir WHMCS veya WISECP modülü kullanan bir ekip için bu süre genellikle birkaç gündür; özel bir REST entegrasyonu için ise OT&E testleri dahil iki ile üç hafta arası daha gerçekçi bir beklentidir.

Domain Reseller API Seçerken Kontrol Listesi

Bir sağlayıcıyı değerlendirirken aşağıdaki maddeleri işaretleyerek ilerlemeniz, sonradan yeniden çalışma ihtiyacını büyük ölçüde azaltır.

REST tabanlı, Swagger üzerinden belgelenmiş bir API sunuluyor mu?

Gerçek verilerle çalışmadan önce test edebileceğiniz bir OT&E / sandbox ortamı var mı?

750+ uzantı gibi geniş bir TLD kapsamı sağlanıyor mu?

Kayıt, transfer, yenileme, DNS ve WHOIS gizliliği tek bir API üzerinden yönetilebiliyor mu?

WHMCS veya WISECP kullanıyorsanız, ücretsiz bir modül mevcut mu?

IP whitelist, API key rotasyonu ve rate limit gibi güvenlik kontrolleri sağlanıyor mu?

Hata kodları ve retry davranışı net şekilde belgelenmiş mi?

Sağlayıcının sektördeki geçmişi ve ölçeği (yıl, ülke, bayi sayısı gibi) doğrulanabiliyor mu?

Sonuç

Bir Domain Reseller API, domain kayıt, transfer ve yenileme işlemlerini manuel ve hataya açık görevlerden otomatik, güvenilir iş akışlarına dönüştürür. Hosting şirketleri, bayiler, web ajansları ve SaaS platformları için bu otomasyon sadece bir kolaylık değildir; büyüyen sipariş hacmini, destek yükünü aynı oranda büyütmeden yönetebilmenizi sağlayan şeydir.

Doğru API'yi seçmek birkaç pratik soruya bağlıdır: tüm domain yaşam döngüsünü kapsıyor mu, gerçek bir sandbox sunuyor mu, zaten kullandığınız faturalandırma veya hosting platformuyla entegre oluyor mu ve size net, iyi belgelenmiş bir hata yönetimi veriyor mu? Bunları baştan doğru yapmak, sonradan ciddi bir yeniden çalışma yükünden tasarruf sağlar.

Başlayın

İster bir hosting platformu kuruyor, ister white-label bir domain işi başlatıyor, ister mevcut bir SaaS ürününe domain kaydını ekliyor olun; OT&E ortamında başlayın, iş akışlarınızı doğrulayın ve production'a güvenle geçin. İhtiyacınız olan altyapı zaten hazır: geriye kalan tek şey, ücretsiz bir reseller hesabı açıp ilk test isteğinizi göndermek.