Alan Adi Bayilik API Referansi

1Baslangic

1. Hesabinizin alan adi bayisi olarak etkinlestirilmesi gerekir; aksi halde uc noktalar yetki hatasi doner.
2. Musteri panelinde Guvenlik bolumunden bir API token uretin ve kapsamini entegrasyonunuzun asgari ihtiyacina daraltin.
3. Kendi sunucunuzun cikis IP sini o tokenin izin listesine ekleyin. IP kisiti olmayan bir token her yerden kullanilabilir.
4. Hesabi fonlayin. Kayit ve yenileme cagri aninda kredinizden tahsil edilir; sonradan odemeli faturalama yoktur.
5. Saglik uc noktasina bir test cagrisi yapin ve donen kademe ile bakiyeyi panelle karsilastirin.

2Kimlik dogrulama ve kapsam

Kimlik dogrulama Authorization basligindaki bearer token ile yapilir. Oturum, cerez veya CSRF katmani yoktur; her istek bagimsiz ve durumsuzdur. Token asla URL de veya tarayici kodunda yer almamalidir.

curl -H "Authorization: Bearer sn_xxxxxxxx" \
     https://servernet.cloud/api/v1/ping

Kapsamlar

Yazma kapsami okuma kapsamini icerir; tersi asla gecerli degildir. Her ortam icin ayri token uretmenizi oneririz.

3Yanit sozlesmesi

Her yanit sabit bicimli bir JSON zarfidir. Istemci mantigi mesaj metnine degil, makine tarafindan okunabilen error tanimlayicisina gore dallanmalidir.

{"ok": true,  "data": { ... }}
{"ok": false, "error": "insufficient_credit", "message": "..."}

4Uc noktalar

Uygunluk ve fiyatlandirma

POST https://servernet.cloud/api/v1/domains/check
{"domain": "example.com", "tlds": ["com", "net"]}

{"ok": true, "data": [{
  "domain": "example.com", "state": "free", "available": true,
  "currency": "IRT",
  "price": {"register": 1150000, "renew": 1250000, "retail": 1320000},
  "discount_pct": 12.88, "price_floored": false
}]}

price_floored degeri true ise, kademe indiriminiz o uzantida tam uygulanmamistir cunku fiyat marj tabanimiza ulasmistir.

Kayit

POST https://servernet.cloud/api/v1/domains
Idempotency-Key: your-order-12345
{"domain": "example.com", "years": 1,
 "nameservers": ["ns1.you.com", "ns2.you.com"]}

{"ok": true, "data": {
  "domain": "example.com", "status": "pending",
  "order_state": "registered", "registrant": "reseller",
  "charged": 1265000, "currency": "IRT"
}}

5Idempotency ve yeniden deneme

Sunucu Idempotency-Key basligi olmayan istekleri de kabul eder, ancak bu durumda hicbir tekrar korumasi uygulanmaz; bu nedenle her ucretli islemde gonderilmesi her entegrasyonun dogruluk sartidir. Anahtar en fazla 80 karakterdir ve is yapilmadan once benzersiz bir veritabani indeksinde talep edilir.

sha256("renew|example.com|2027-01-01|1")

Ayni anahtari koruyarak ussel geri cekilme ve jitter ile yeniden deneyin; yeniden denemede yeni anahtar uretmek tum garantiyi bozar.

6Hata tanimlayicilari

7Fiyatlandirma ve kademeler

API nin dondurdugu fiyat alis fiyatinizdir: perakende eksi kademe indirimi. Kademe, son on iki aylik hacim ve aktif portfoy buyuklugunden ayni anda turetilir.

• Yukseltmeler aninda uygulanir.
• Dususler kademelidir: once ek sure, sonra en fazla bir basamak. Bu asimetri kasitlidir.
• Mevcut kademeniz ve bir sonraki esige uzakliginiz bayi panelinde ve saglik uc noktasi yanitinda mevcuttur.

Marj tabani

Marjimiz uzantiya gore degisir ve ilgili registry nin maliyet yapisini izler. Dusuk marjli uzantilarda indirim yalnizca maliyetimizin ustunde kalan bir tabana kadar uygulanir.

Bu kisitin acikca belirtilmesi bilincli bir tercihtir. Beyan edilmemis bir taban, istemcinin mutabakat yapamayacagi bir fark uretir.

8Kotalar ve limitler

Hiz limitinin asilmasi 429 doner ve daha fazla es zamanlilikla degil geri cekilmeyle yonetilmelidir. Ayrica her hesabin gunluk harcama limiti vardir.

9Bilerek kapsam disi

Asagidakiler eksik degil, token yuzeyinden bilerek cikarilmistir. Olcut acik: ele gecirilmis bir tokenla son musteri alan adinin kontrolunu devreden her islem yalnizca panelde insan dogrulamasiyla yapilir.

10Resmi moduller

Bu arayuze karsi iki referans uygulama surdurulmektedir; ikisi de bayi panelinden indirilebilir. Yiginiz bunlardan biriyse el yazimi entegrasyon yerine modulu tercih edin.

11Yol haritasi

Asagidakiler planlanmistir ancak v1 arayuzunde henuz yayinlanmamistir. Yayina kadar ilgili uc nokta 404 doner. Uc nokta eklemek geriye donuk uyumlu bir degisikliktir.

Panel PDF surumu