Integrace

Integrace s ISPmanager

NexDNS je plně kompatibilní s API DNSmanager, takže NexDNS můžete připojit k ISPmanager jako sekundární (slave) DNS server. ISPmanager zůstává primární a poté, co povolíte přenos zóny (AXFR) ze zdrojové IP adresy NexDNS, přenáší každou zónu do NexDNS, takže záznamy nadále spravujete v ISPmanager. Kompletní API DNSmanager pro domény a záznamy je rovněž k dispozici k přímému použití prostřednictvím jednoho kompatibilního endpointu.

Koncový bod

Všechna volání kompatibilního API jsou směrována přes jeden endpoint:

https://api.nexdns.tech/dnsmgr

Autentizace

Kompatibilní API se autentizuje pomocí vyhrazeného integračního přihlašovacího jména a tajného klíče, které si vygenerujete v NexDNS v sekci Účet → Integrace (nikoli heslo vašeho účtu). ISPmanager je odesílá s každým požadavkem; relaci můžete také otevřít ručně pomocí funkce func=auth a vrácený token znovu použít.

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

Úspěšná odpověď (XML):

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

Výstup ve formátu JSON si můžete vyžádat přidáním out=json k jakémukoli požadavku. Opakovaně neúspěšná přihlášení jsou dočasně omezována.

Podporované funkce

Kompatibilní API směruje operace na základě parametru dotazu func:

Připojení ISPmanager k NexDNS

Chcete-li připojit ISPmanager k NexDNS:

1. Zaregistrujte si účet NexDNS na nexdns.tech a zvolte tarif, který zahrnuje integraci s ISPmanager a sekundární DNS.
2. Nastavte integraci v NexDNS: otevřete Účet → Integrace, klikněte na Vygenerovat tajný klíč a poté zapněte přístup pro ISPmanager (ve výchozím nastavení vypnuto). Tento kanál obchází dvoufaktorové ověření, proto jej volitelně omezte na pevnou IP adresu.
3. V ISPmanager přidejte NexDNS jako sekundární (slave) DNS server pro vaše domény (Doménová jména → sekundární nameservery).
4. Zadejte údaje pro připojení:
   • Adresa URL: https://api.nexdns.tech/dnsmgr
   • Přihlašovací jméno: vaše integrační přihlašovací jméno z Účet → Integrace
   • Tajný klíč: váš integrační tajný klíč
5. Povolte přenos zóny (AXFR): na svém primárním DNS serveru povolte přenos zóny ze zdrojové IP adresy NexDNS uvedené v sekci Účet → Integrace. Bez toho ISPmanager sekundární zónu vytvoří, ale zůstane prázdná.

ISPmanager zůstává primárním serverem a záznamy spravujete dál v něm; NexDNS stahuje každou zónu jako sekundární přes AXFR. Jednorázový krok na vaší straně: na svém primárním DNS serveru povolte přenos zóny (AXFR) ze zdrojové IP adresy NexDNS uvedené v sekci Účet → Integrace, jinak zůstanou zóny prázdné. Ověřování používá přihlašovací jméno a tajný klíč integrace z Účet → Integrace; ujistěte se, že je přístup ISPmanageru povolen a váš tarif zahrnuje sekundární DNS.

Parametry záznamů

Při vytváření nebo aktualizaci záznamů prostřednictvím domain.record.edit se v závislosti na typu záznamu používají následující parametry:

Pro aktualizace předejte rkey s ID existujícího záznamu. Vynechejte rkey (nebo odešlete prázdné) pro vytvoření nového záznamu.

Výstupní formát

Ve výchozím nastavení jsou všechny odpovědi vráceny jako XML. Přidejte out=json k jakémukoli požadavku pro příjem odpovědí ve formátu JSON.

Správa API klíčů

API klíče slouží k autentizaci požadavků na NexDNS REST API. Každý klíč má definovaná oprávnění a volitelně datum expirace.

Vytvoření API klíče

API klíče můžete vytvořit dvěma způsoby:

• Panel UI: Přejděte na Nastavení > API klíče a klikněte na "Vytvořit API klíč"
• REST API: POST /v1/account/api-keys (vyžaduje existující API klíč)

Formát klíče

API klíče mají formát nxd_ následovaný 40 náhodnými alfanumerickými znaky. Úplný klíč je zobrazen pouze jednou při vytvoření. NexDNS ukládá pouze hashovanou podobu klíče, takže ho nelze obnovit v případě ztráty.

nxd_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcd

Oprávnění

Každému API klíči musí být přiřazeno alespoň jedno oprávnění. Dostupná oprávnění:

Doporučujeme každému klíči udělit pouze oprávnění, která potřebuje.

Expirace

API klíče mohou mít volitelně datum expirace. Pokud je nastaveno, klíč přestane fungovat po zadaném datu (kontrolováno o půlnoci UTC). Prošlé klíče vrací odpověď 401 Unauthorized.

Zneplatnění klíče

Jakýkoli API klíč můžete kdykoli zneplatnit ze stránky Nastavení nebo prostřednictvím API. Zneplatnění je okamžité a trvalé – klíč je smazán, nikoli deaktivován.

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

Požadavky na tarif

Přístup k API vyžaduje tarif předplatného, který zahrnuje funkci api_access.

Omezení počtu požadavků

NexDNS API vynucuje omezení počtu požadavků pro zajištění spravedlivého využívání a stability služby. Limity jsou uplatňovány na uživatelský účet (nikoli na API klíč), takže použití více API klíčů váš limit nezvyšuje.

Limity

Neautentizované požadavky (nebo požadavky s neplatnými klíči) jsou omezovány podle IP adresy.

Hlavičky omezení počtu požadavků

Každá odpověď API obsahuje hlavičky udávající aktuální stav vašeho limitu požadavků:

Překročení limitu

Při překročení limitu požadavků API vrací 429 Too Many Requests:

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