Dokumentacja API Simply.com

Możesz znaleźć punkt końcowy HTTP na https://api.simply.com/2/ - poprzedź swoje zapytania tym.

Przykład: https://api.simply.com/2/my/products/

Uwierzytelnianie odbywa się za pomocą HTTP Basic Authentication.

Nazwa użytkownika jest numerem konta Simply.com (Sxxxxxx).

Hasło jest kluczem API dla konkretnego konta.

Zarówno numer konta, jak i klucz API przypisane do Twojego konta Simply.com można znaleźć w panelu kontrolnym Simply.com.

Możesz znaleźć specyfikację OpenAPI dla API tutaj: https://api.simply.com/2/openapi.json .

Rozważ użycie przeglądarki Swagger UI tutaj: https://generator.swagger.io/ .

API podlega ograniczeniom szybkości, tylko w celu zapobiegania nadużyciom.

Możesz zobaczyć limit i zużycie w X-RateLimit-Limit i X-RateLimit-Remaining nagłówki.

Następujące biblioteki są dostępne do użytku.

Implementacje ACME

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

Implementacje API

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

Punkty końcowe /ddns/ i /dyndns/ pomaga łatwo skonfigurować DDNS na domenie.

/dyndns/ emuluje ściśle protokół DynDns, podczas gdy /ddns/ próbuje udzielać bardziej opisowych odpowiedzi i akceptuje więcej argumentów.

Przykład Curl (Zalecane)

Użyj następującego polecenia Curl, aby ustawić home.example.com do zewnętrznego IP klienta żądającego:

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

Możesz ustawić tę komendę, aby działała w crontab na lokalnej maszynie co 15 minut lub coś koło tego.

Synology

Na Synology możesz użyć następującej składni jako niestandardowego dostawcy DDNS.

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

hostname należy następnie podać jako pełną kwalifikowaną nazwę domeny, którą chcesz zaktualizować, np. 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

W UniFi OS musisz skonfigurować niestandardowego dostawcę Dynamicznego DNS i wpisać następujący ciąg w polu "Serwer".

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