Simply.com API dokumentáció

Az HTTP végpontot megtalálhatja itt https://api.simply.com/2/ - Adj előtagot a kérdéseidhez ezzel.

Példa: https://api.simply.com/2/my/products/

A hitelesítés HTTP Basic Authentication segítségével történik.

Felhasználónév a Simply.com számlaszáma (Sxxxxxx).

Jelszó az API-kulcs a konkrét fiókhoz.

A Simply.com fiókodhoz rendelt számlaszám és API‑kulcs is megtalálható a Simply.com vezérlőpultodban.

Itt találod az API OpenAPI specifikációját.: https://api.simply.com/2/openapi.json .

Fontolja meg a Swagger UI böngésző használatát itt: https://generator.swagger.io/ .

Az API rate limitnek van kitéve, csak a visszaélés megelőzése érdekében.

Megtekintheti a korlátot és a felhasználást a X-RateLimit-Limit és X-RateLimit-Remaining fejlécek.

A következő könyvtárak felhasználásra elérhetők.

ACME implementációk

acme.sh	https://github.com/acmesh-official/acme.sh/
Posh-ACME	https://github.com/rmbolger/Posh-ACME/
cert-manager service	https://github.com/RunnerM/simply-dns-webhook/
Certbot plugin	https://github.com/JohNan/certbot-dns-simply/
Webhook provider for ExternalDNS	https://github.com/uozalp/external-dns-simply-webhook

API megvalósítások

PHP	https://github.com/simplycom/api-php/

Végpontok /ddns/ és /dyndns/ Segít neked könnyen beállítani a DDNS-t egy domainen.

/dyndns/ szigorúan emulálja a DynDns protokollt, miközben /ddns/ próbál részletesebb válaszokat adni, és több érvet elfogad.

Curl példa (Ajánlott)

Használja a következő Curl parancsot a beállításhoz home.example.com a kérő kliens külső IP-címéhez:

curl -s -u "ACCOUNTNAME:APIKEY" "https://api.simply.com/2/ddns/?domain=example.com&hostname=home.example.com"

Beállíthatja ezt a parancsot, hogy egy crontabban fusson, egy helyi gépen, körülbelül 15 percenként.

Synology

A Synology‑nél a következő szintaxist használhatja egyéni DDNS szolgáltatóként

https://api.simply.com/2/dyndns/?hostname=__HOSTNAME__&myip=__MYIP__

hostname Ezután a teljesen kvalifikált domain nevet kell megadni, amelyet frissíteni szeretne, például. home.example.com.

Home Assistant

# In configuration.yaml file
rest_command:
  simplycom_ddns:
    username: "ACCOUNTNAME"
    password: "APIKEY"
url: "https://api.simply.com/2/ddns/?domain=example.com&hostname=home.example.com"

# Automation
alias: Simply.com DDNS
trigger:
- platform: time_pattern
  minutes: "0"
  seconds: "0"
action:
- service: rest_command.simplycom_ddns

Unifi

Az UniFi OS‑ben be kell állítanod egy Custom Dynamic DNS szolgáltatót, és be kell írnod a következő karakterláncot a "Server" mezőbe.

api.simply.com/2/dyndns/?hostname=%h&myip=%i