Acest document descrie API-ul RESTful JSON al Simply.com.
Poți găsi endpoint‑ul HTTP la https://api.simply.com/2/ - prefixează-ți interogările cu acesta.
Autentificarea se face cu HTTP Basic Authentication.
Nume de utilizator este numărul de cont Simply.com (Sxxxxxx).
Parolă este cheia API pentru contul specific.
Atât numărul de cont, cât și cheia API atribuite contului tău Simply.com pot fi găsite în panoul de control Simply.com.
Poți găsi specificația OpenAPI pentru API aici: https://api.simply.com/2/openapi.json .
Luați în considerare să folosiți browserul Swagger UI aici: https://generator.swagger.io/ .
API este supus limitelor de rată, doar pentru a preveni abuzul.
Poți vedea limita și consumul în X-RateLimit-Limit și X-RateLimit-Remaining anteturi.
Următoarele biblioteci sunt disponibile pentru utilizare.
| 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 |
| PHP | https://github.com/simplycom/api-php/ |
|---|
Punctele finale /ddns/ și /dyndns/ te ajută ușor să configurezi DDNS pe un domeniu.
/dyndns/ emulează strict protocolul DynDns, în timp ce /ddns/ încearcă să ofere răspunsuri mai descriptive și acceptă mai multe argumente.
Folosește următoarea comandă Curl pentru a seta home.example.com la IP‑ul extern al clientului solicitant:
curl -s -u "ACCOUNTNAME:APIKEY" "https://api.simply.com/2/ddns/?domain=example.com&hostname=home.example.com"
Poți seta această comandă să ruleze într-un crontab, pe o mașină locală, la fiecare 15 min sau cam.
Pe Synology poţi folosi următoarea sintaxă ca furnizor DDNS personalizat
https://api.simply.com/2/dyndns/?hostname=__HOSTNAME__&myip=__MYIP__
hostname trebuie apoi să fie specificat ca numele de domeniu complet calificat pe care doriți să îl actualizați, de exemplu. home.example.com.
# 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
În UniFi OS trebuie să configurezi un furnizor DNS dinamic personalizat și să introduci șirul următor în câmpul „Server”.
api.simply.com/2/dyndns/?hostname=%h&myip=%i