Entegrasyonlar

ISPmanager Entegrasyonu

NexDNS, DNSmanager API'si ile tamamen uyumludur; bu sayede NexDNS'i ISPmanager'a ikincil (slave) DNS sunucusu olarak bağlayabilirsiniz. ISPmanager birincil olarak kalır ve NexDNS kaynak IP'sinden bölge aktarımına (AXFR) izin verdiğinizde her bölgeyi NexDNS'e aktarır, böylece kayıtları ISPmanager'da yönetmeye devam edersiniz. Tüm DNSmanager alan adı ve kayıt API'si ayrıca tek bir uyumluluk uç noktası üzerinden doğrudan kullanılabilir.

Uç Nokta

Tüm uyumluluk API çağrıları tek bir uç nokta üzerinden yönlendirilir:

https://api.nexdns.tech/dnsmgr

Kimlik Doğrulama

Uyumluluk API'si, NexDNS'te Hesap → Entegrasyonlar bölümünde oluşturduğunuz özel bir entegrasyon girişi ve gizli anahtarı ile kimlik doğrulaması yapar (hesap parolanızla değil). ISPmanager bunları her istekte gönderir; ayrıca func=auth işlevi ile manuel olarak bir oturum açıp döndürülen belirteci yeniden kullanabilirsiniz.

curl -X POST "https://api.nexdns.tech/dnsmgr?func=auth" \
    -d "username=your_integration_login" \
    -d "password=your_integration_secret"

Başarılı yanıt (XML):

<doc><auth id="SESSION_ID"/></doc>

Herhangi bir isteğe out=json ekleyerek JSON çıktısı isteyebilirsiniz. Tekrarlanan başarısız girişler geçici olarak kısıtlanır.

Desteklenen İşlevler

Uyumluluk API'si, func sorgu parametresine göre işlemleri yönlendirir:

ISPmanager'ı NexDNS'e Bağlama

ISPmanager'ı NexDNS'e bağlamak için:

1. nexdns.tech adresinde bir NexDNS hesabı oluşturun ve ISPmanager entegrasyonu ile ikincil DNS içeren bir plan seçin.
2. NexDNS'te entegrasyonu kurun: Hesap → Entegrasyonlar bölümünü açın, Gizli anahtar oluştur'a tıklayın, ardından ISPmanager erişimini açın (varsayılan olarak kapalıdır). Bu kanal iki adımlı doğrulamayı atlar; bu nedenle isteğe bağlı olarak sabit bir IP adresine sınırlayın.
3. ISPmanager'da, alan adlarınız için NexDNS'i ikincil (slave) DNS sunucusu olarak ekleyin (Alan adları → ikincil ad sunucuları).
4. Bağlantı bilgilerini girin:
   • Adres: https://api.nexdns.tech/dnsmgr
   • Giriş: Hesap → Entegrasyonlar bölümündeki entegrasyon girişiniz
   • Gizli anahtar: entegrasyon gizli anahtarınız
5. Bölge aktarımına (AXFR) izin verin: birincil DNS sunucunuzda, Hesap → Entegrasyonlar bölümünde gösterilen NexDNS kaynak IP'sinden bölge aktarımına izin verin. Bu olmadan ISPmanager ikincil bölgeyi oluşturur ancak boş kalır.

ISPmanager birincil olarak kalır ve kayıtları orada yönetmeye devam edersiniz; NexDNS her bölgeyi AXFR ile ikincil olarak çeker. Sizin tarafınızda tek seferlik adım: birincil DNS sunucunuzda, Hesap → Entegrasyonlar bölümünde gösterilen NexDNS kaynak IP'sinden bölge aktarımına (AXFR) izin verin; aksi halde bölgeler boş görünür. Kimlik doğrulama, Hesap → Entegrasyonlar bölümündeki entegrasyon girişini ve gizli anahtarını kullanır; ISPmanager erişiminin etkin olduğundan ve planınızın ikincil DNS içerdiğinden emin olun.

Kayıt Parametreleri

domain.record.edit aracılığıyla kayıt oluştururken veya güncellerken, kayıt türüne bağlı olarak aşağıdaki parametreler kullanılır:

Güncellemeler için mevcut kayıt kimliğiyle birlikte rkey parametresini geçirin. Yeni bir kayıt oluşturmak için rkey parametresini atlayın (veya boş gönderin).

Çıktı Formatı

Varsayılan olarak tüm yanıtlar XML olarak döndürülür. Bunun yerine JSON yanıtları almak için herhangi bir isteğe out=json ekleyin.

API Anahtarı Yönetimi

API anahtarları, NexDNS REST API'sine yapılan isteklerin kimlik doğrulaması için kullanılır. Her anahtar belirli izinlerle kapsamlandırılır ve isteğe bağlı olarak bir son kullanma tarihi olabilir.

API Anahtarı Oluşturma

API anahtarlarını iki şekilde oluşturabilirsiniz:

• Panel arayüzü: Ayarlar > API Anahtarları bölümüne gidin ve "API Anahtarı Oluştur" düğmesine tıklayın
• REST API: POST /v1/account/api-keys (mevcut bir API anahtarı gerektirir)

Anahtar Formatı

API anahtarları, nxd_ öneki ve ardından gelen 40 rastgele alfanümerik karakter formatını izler. Tam anahtar yalnızca oluşturma sırasında bir kez gösterilir. NexDNS, anahtarın yalnızca karma biçimini saklar, bu nedenle kaybolursa kurtarılamaz.

nxd_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcd

İzinler

Her API anahtarına en az bir izin atanmalıdır. Mevcut izinler:

Her anahtara yalnızca ihtiyaç duyduğu izinleri vermenizi öneririz.

Son Kullanma

API anahtarları isteğe bağlı olarak bir son kullanma tarihine sahip olabilir. Ayarlandığında anahtar, belirtilen tarihten sonra çalışmayı durdurur (UTC gece yarısında kontrol edilir). Süresi dolmuş anahtarlar 401 Unauthorized yanıtı döndürür.

Anahtarı İptal Etme

Herhangi bir API anahtarını istediğiniz zaman Ayarlar sayfasından veya API aracılığıyla iptal edebilirsiniz. İptal anında ve kalıcıdır – anahtar devre dışı bırakılmaz, silinir.

curl -X DELETE "https://api.nexdns.tech/v1/account/api-keys/{id}" \
    -H "Authorization: Bearer nxd_your_api_key"

Plan Gereksinimleri

API erişimi, api_access özelliğini içeren bir abonelik planı gerektirir.

Hız Sınırlama

NexDNS API'si, adil kullanım ve hizmet kararlılığını sağlamak için hız sınırları uygular. Hız sınırları kullanıcı hesabı başına uygulanır (API anahtarı başına değil), bu nedenle birden fazla API anahtarı kullanmak sınırınızı artırmaz.

Sınırlar

Kimliği doğrulanmamış istekler (veya geçersiz anahtarlı istekler) IP adresine göre hız sınırlandırılır.

Hız Sınırı Başlıkları

Her API yanıtı, mevcut hız sınırı durumunuzu gösteren başlıklar içerir:

Sınırın Aşılması

Hız sınırı aşıldığında API, 429 Too Many Requests döndürür:

{
    "status": "error",
    "error": {
        "code": "rate_limit_exceeded",
        "message": "Too many requests. Please retry after {timestamp}."
    }
}