API

Domain ve DNS işlemlerini kendi yazılımından veya yapay zekâ asistanından yönet. REST, JSON, Bearer anahtar.

Temel bilgiler

Adres: https://domain.roddijital.com/api/v1
Kimlik doğrulama: Authorization: Bearer rd_…
Yetkiler: Sadece okuma anahtarı listeleme ve sorgulama yapar; değişiklik ve hassas bilgi (transfer kodu, şifre, özel anahtar) için okuma + yazma anahtarı gerekir.
Yanıt biçimi: Başarılı: { "data": … } · Hata: { "error": { "code", "message" } }
Limit: Anahtar başına dakikada 120 istek; müsaitlik sorgusu 30, DNS değişikliği 60. Aşılırsa 429 döner.
Alan adları: Türkçe karakterli adlar doğrudan yazılabilir (örn. örnek.com); yanıtta hem punycode hem okunur ad döner.

Hesap

get/meokuma

Anahtar ve hesap bilgisi

curl "https://domain.roddijital.com/api/v1/me" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": {
    "id": "usr_…",
    "name": "Ad Soyad",
    "email": "ad@ornek.com",
    "key": {
      "name": "CI",
      "prefix": "rd_aB3dE6g",
      "scopes": [
        "read",
        "write"
      ]
    },
    "services": {
      "domain": 3,
      "ssl": 1
    }
  }
}

get/pricesokuma

Uzantı fiyatları

TL, KDV hariç, yıllık.

tldssorguVirgülle ayrılmış uzantılar

curl "https://domain.roddijital.com/api/v1/prices?tlds=com%2Cnet%2Ccom.tr" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": {
    "currency": "TRY",
    "vat_rate": 20,
    "vat_included": false,
    "tlds": [
      {
        "tld": "com",
        "register": 762.99,
        "renew": 781.99,
        "transfer": 736.99,
        "periods": [
          1,
          2,
          3
        ]
      }
    ]
  }
}

Domain

get/domainsokuma

Domainleri listele

curl "https://domain.roddijital.com/api/v1/domains" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": [
    {
      "name": "ornek.com",
      "unicode_name": "ornek.com",
      "status": "active",
      "created_at": "2026-11-01T15:31:00.000Z",
      "expires_at": "2027-11-01T15:31:00.000Z",
      "locked": true,
      "privacy": false,
      "nameservers": [
        "ns1.example.com",
        "ns2.example.com"
      ]
    }
  ]
}

get/domains/checkokuma

Müsaitlik sorgula

Tek istekte en fazla 10 domain, dakikada 30 istek.

namesorgu, zorunluAlan adı ya da yalnızca ad
tldssorguAd ile birleştirilecek uzantılar

curl "https://domain.roddijital.com/api/v1/domains/check?name=ornek&tlds=com%2Cnet%2Ccom.tr" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": [
    {
      "name": "ornek.com",
      "unicode_name": "ornek.com",
      "status": "available",
      "price": 762.99,
      "currency": "TRY",
      "vat_included": false
    }
  ]
}

get/domains/{domain}okuma

Domain detayı

Sicildeki güncel bilgi. registry_status: active, pending, pending_document, pending_verification, pending_restore, redemption, suspended, register_failed, transfer_in, transfer_failed, deleted, transferred_out, unknown.

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl "https://domain.roddijital.com/api/v1/domains/ornek.com" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": {
    "name": "ornek.com",
    "unicode_name": "ornek.com",
    "status": "active",
    "created_at": "2026-11-01T15:31:00.000Z",
    "expires_at": "2027-11-01T15:31:00.000Z",
    "locked": true,
    "privacy": false,
    "nameservers": [
      "ns1.example.com",
      "ns2.example.com"
    ],
    "registry_status": "active",
    "hosts": [],
    "forwarded": false
  }
}

get/domains/{domain}/nameserversokuma

Nameserver'ları getir

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl "https://domain.roddijital.com/api/v1/domains/ornek.com/nameservers" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": {
    "nameservers": [
      "ns1.example.com",
      "ns2.example.com"
    ]
  }
}

put/domains/{domain}/nameserversokuma + yazma

Nameserver'ları değiştir

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl -X PUT "https://domain.roddijital.com/api/v1/domains/ornek.com/nameservers" \
  -H "Authorization: Bearer $RD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nameservers":["ns1.ornek-dns.com","ns2.ornek-dns.com"]}'

Örnek yanıt

{
  "data": {
    "nameservers": [
      "ns1.ornek-dns.com",
      "ns2.ornek-dns.com"
    ]
  }
}

put/domains/{domain}/lockokuma + yazma

Transfer kilidi

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl -X PUT "https://domain.roddijital.com/api/v1/domains/ornek.com/lock" \
  -H "Authorization: Bearer $RD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"locked":false}'

Örnek yanıt

{
  "data": {
    "locked": false
  }
}

put/domains/{domain}/privacyokuma + yazma

Whois gizliliği

pending: true ise sağlayıcı sahip e-posta doğrulamasını bekliyor; değişiklik doğrulamadan sonra uygulanır (genelde gizliliği kapatırken).

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl -X PUT "https://domain.roddijital.com/api/v1/domains/ornek.com/privacy" \
  -H "Authorization: Bearer $RD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled":true}'

Örnek yanıt

{
  "data": {
    "privacy": true,
    "pending": false
  }
}

get/domains/{domain}/auth-codeokuma + yazma

Transfer (EPP) kodu

Hassas bilgi olduğu için yazma yetkisi ister.

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl "https://domain.roddijital.com/api/v1/domains/ornek.com/auth-code" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": {
    "auth_code": "aB3#dE6!gH"
  }
}

post/domains/{domain}/auth-codeokuma + yazma

Yeni transfer kodu üret

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl -X POST "https://domain.roddijital.com/api/v1/domains/ornek.com/auth-code" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": {
    "auth_code": "xY9$zW2!qR"
  }
}

get/domains/{domain}/forwardingokuma

Yönlendirmeyi getir

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl "https://domain.roddijital.com/api/v1/domains/ornek.com/forwarding" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": {
    "forwarding": {
      "url": "https://ornek.net/",
      "type": "Standard"
    }
  }
}

put/domains/{domain}/forwardingokuma + yazma

Yönlendirme ayarla

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl -X PUT "https://domain.roddijital.com/api/v1/domains/ornek.com/forwarding" \
  -H "Authorization: Bearer $RD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://ornek.net","type":"Standard"}'

Örnek yanıt

{
  "data": {
    "forwarding": {
      "url": "https://ornek.net/",
      "type": "Standard"
    }
  }
}

delete/domains/{domain}/forwardingokuma + yazma

Yönlendirmeyi kaldır

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl -X DELETE "https://domain.roddijital.com/api/v1/domains/ornek.com/forwarding" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": {
    "forwarding": null
  }
}

get/domains/{domain}/hostsokuma

Child nameserver'lar

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl "https://domain.roddijital.com/api/v1/domains/ornek.com/hosts" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": [
    {
      "host": "ns1.ornek.com",
      "ips": [
        "192.0.2.10"
      ]
    }
  ]
}

post/domains/{domain}/hostsokuma + yazma

Child nameserver ekle

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl -X POST "https://domain.roddijital.com/api/v1/domains/ornek.com/hosts" \
  -H "Authorization: Bearer $RD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"host":"ns1","ip":"192.0.2.10"}'

Örnek yanıt

{
  "data": {
    "host": "ns1.ornek.com",
    "ips": [
      "192.0.2.10"
    ]
  }
}

delete/domains/{domain}/hostsokuma + yazma

Child nameserver sil

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)
hostsorgu, zorunluHost adı

curl -X DELETE "https://domain.roddijital.com/api/v1/domains/ornek.com/hosts?host=ns1" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": {
    "deleted": true
  }
}

DNS

get/domains/{domain}/dnsokuma

DNS kayıtlarını listele

Kayıtlar ad + tür kümeleri olarak döner. Varsayılan nameserver'lar gerekir.

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl "https://domain.roddijital.com/api/v1/domains/ornek.com/dns" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": [
    {
      "name": "@",
      "type": "A",
      "ttl": 3600,
      "values": [
        "192.0.2.10"
      ]
    },
    {
      "name": "www",
      "type": "CNAME",
      "ttl": 3600,
      "values": [
        "ornek.com."
      ]
    }
  ]
}

put/domains/{domain}/dnsokuma + yazma

Kayıt kümesi oluştur / değiştir

Aynı ad ve türdeki tüm değerler verilenlerle değiştirilir; tekrar çağırmak güvenlidir. Tür: A, AAAA, ALIAS, CAA, CNAME, MX, NAPTR, SRV, TLSA, TXT.

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)

curl -X PUT "https://domain.roddijital.com/api/v1/domains/ornek.com/dns" \
  -H "Authorization: Bearer $RD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"www","type":"A","ttl":3600,"values":["192.0.2.10","192.0.2.11"]}'

Örnek yanıt

{
  "data": {
    "name": "www",
    "type": "A",
    "ttl": 3600,
    "values": [
      "192.0.2.10",
      "192.0.2.11"
    ]
  }
}

delete/domains/{domain}/dnsokuma + yazma

Kayıt sil

value verilirse yalnızca o değer, verilmezse tüm küme silinir.

domainyol, zorunluAlan adı (Türkçe karakterli olabilir)
namesorgu, zorunluKayıt adı, kök için @
typesorgu, zorunluKayıt türü
valuesorguSilinecek tek değer

curl -X DELETE "https://domain.roddijital.com/api/v1/domains/ornek.com/dns?name=www&type=A&value=192.0.2.11" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": {
    "deleted": true
  }
}

Sipariş

get/ordersokuma

Siparişleri listele

curl "https://domain.roddijital.com/api/v1/orders" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": [
    {
      "number": "RD26110133481",
      "status": "completed",
      "currency": "TRY",
      "subtotal": 762.99,
      "vat": 152.6,
      "total": 915.59
    }
  ]
}

get/orders/{number}okuma

Sipariş detayı

numberyol, zorunluSipariş numarası

curl "https://domain.roddijital.com/api/v1/orders/RD26110133481" \
  -H "Authorization: Bearer $RD_API_KEY"

Örnek yanıt

{
  "data": {
    "number": "RD26110133481",
    "status": "completed",
    "items": [
      {
        "kind": "domain_register",
        "name": "ornek.com",
        "period_years": 1,
        "price": 762.99,
        "status": "completed",
        "error": null
      }
    ]
  }
}