Simply.com API dokumentatsioon

Saate leida HTTP lõpp-punkti aadressil https://api.simply.com/2/ - eelista oma päringud sellega.

Näide: https://api.simply.com/2/my/products/

Autentimine toimub HTTP Basic Authentication abil.

kasutajanimi on Simply.com kontonumber (Sxxxxxx).

Parool on API-võti konkreetse konto jaoks.

Nii Kontonumber kui ka API-võti, mis on määratud teie Simply.com kontole, leiate oma Simply.com juhtpaneelist.

Leiate API OpenAPI spetsifikatsiooni siit: https://api.simply.com/2/openapi.json.

Kaaluge Swagger UI brauseri kasutamist siin: https://generator.swagger.io/.

API on allutatud kiiruspiirangutele, ainult kuritarvitamise vältimiseks.

Saate vaadata piiri ja kasutust X-RateLimit-Limit ja X-RateLimit-Remaining päised.

Järgmised teegid on kasutamiseks saadaval.

ACME rakendused

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 rakendused

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

Lõpp-punktid /ddns/ ja /dyndns/ aitab teil hõlpsasti DDNS-i domeenile seadistada.

/dyndns/ emuleerib rangelt DynDns protokolli, samal ajal /ddns/ püüab anda rohkem kirjeldavaid vastuseid ja aktsepteerib rohkem argumente.

Curl näide (Soovitatud)

Kasutage järgmine Curl käsk, et seada home.example.com välise IP-aadressi jaoks taotlevast kliendist:

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

Saate selle käsu seadistada crontab-is kohalikus masinas käivituma iga 15 minuti järel või umbes nii.

Synology

Synology's saate kasutada järgmist süntaksit kui Custom DDNS Provider

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

hostname peab seejärel määrata täielikult kvalifitseeritud domeeninimena, mida soovite uuendada, nt. 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

UniFi OS-is peate seadistama kohandatud dünaamilise DNS-i pakkuja ja sisestama järgmise stringi "Server" väljale.

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