Přehled

AdGuard DNS poskytuje rozhraní REST API, které můžete použít k integraci svých aplikací.

Ověřování

Generování přístupového tokenu

Proveďte požadavek POST na následující URL s danými parametry a vygenerujte access_token:

https://api.adguard-dns.io/oapi/v1/oauth_token

Parametr	Popis
uživ. jméno	E-mail účtu
heslo	Heslo účtu
mfa_token	Dvoufaktorový ověřovací token (pokud je povolen v nastavení účtu)

V odpovědi obdržíte jak access_token, tak i refresh_token.

• Platnost code_token vyprší po několika zadaných sekundách (reprezentovaných hodnotou parametrem expires_in v odpovědi). Můžete znovu vygenerovat nový code_token pomocí refresh_token (viz: Generate Access Token from Refresh Token).

• refresh_token je trvalý. Odvolání refresh_token, viz: Revoking a Refresh Token.

Příklad požadavku

$ curl 'https://api.adguard-dns.io/oapi/v1/oauth_token' -i -X POST \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -d 'username=user%40adguard.com' \
    -d 'password=********' \
    -d 'mfa_token=727810'

Příklad odpovědi

{
  "access_token": "jTFho_aymtN20pZR5RRSQAzd81I",
  "token_type": "bearer",
  "refresh_token": "H3SW6YFJ-tOPe0FQCM1Jd6VnMiA",
  "expires_in": 2620978
}

Generování přístupového tokenu z obnovovacího tokenu

Přístupové tokeny mají omezenou platnost. Po vypršení jeho platnosti bude muset vaše aplikace použít refresh_token a požádat o nový access_token.

Pro získání nového přístupového tokenu proveďte následující požadavek POST se zadanými parametry:

https://api.adguard-dns.io/oapi/v1/oauth_token

Parametr	Popis
refresh_token	REFRESH TOKEN, pomocí kterého je třeba vygenerovat nový access_token.

Příklad požadavku

$ curl 'https://api.adguard-dns.io/oapi/v1/oauth_token' -i -X POST \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -d 'refresh_token=H3SW6YFJ-tOPe0FQCM1Jd6VnMiA'

Příklad odpovědi

{
  "access_token": "xQnT7GYT6Ag--3oY_EcOOdXe-I0",
  "token_type": "bearer",
  "refresh_token": "H3SW6YFJ-tOPe0FQCM1Jd6VnMiA",
  "expires_in": 2627999
}

Odvolání obnovovacího tokenu

Chcete-li odvolat obnovovací token, proveďte následující požadavek POST s danými parametry:

https://api.adguard-dns.io/oapi/v1/revoke_token

Příklad požadavku

$ curl 'https://api.adguard-dns.com/oapi/v1/revoke_token' -i -X POST \
    -d 'token=H3SW6YFJ-tOPe0FQCM1Jd6VnMiA'

Parametr	Popis
refresh_token	REFRESH TOKEN, který má být odvolán

Přístup k rozhraní API

Po vygenerování přístupových a obnovovacích tokenů lze volání API provádět pomocí předání přístupového tokenu v záhlaví.

• Název záhlaví by měl být Autorization
• Hodnota záhlaví by měla být Bearer {access_token}

API

Odkaz

Viz odkaz na metody zde.

Specifikace OpenAPI

Specifikace OpenAPI je k dispozici na https://api.adguard-dns.io/static/swagger/openapi.json.

K zobrazení seznamu dostupných metod API můžete použít různé nástroje. Tento soubor můžete otevřít například v https://editor.swagger.io/.

Seznam změn

Kompletní seznam změn AdGuard DNS API je k dispozici na této stránce.

Zpětná vazba

Pokud si přejete, aby bylo toto rozhraní API rozšířeno o nové metody, napište nám prosím na adresu. devteam@adguard.com a sdělte nám, co byste chtěli přidat.