Simply.com API-dokumentasjon

Du kan finne HTTP-endepunktet på https://api.simply.com/2/ - prefiks dine forespørsler med dette.

Eksempel: https://api.simply.com/2/my/products/

Autentisering skjer med HTTP Basic Authentication.

Brukernavn er Simply.com Kontonummeret (Sxxxxxx).

Passord er API-nøkkelen for den spesifikke kontoen.

Både kontonummer og API-nøkkel tildelt din Simply.com-konto kan finnes i ditt Simply.com-kontrollpanel.

Du kan finne OpenAPI-spesifikasjonen for API her: https://api.simply.com/2/openapi.json.

Vurder å bruke Swagger UI-nettleseren her: https://generator.swagger.io/.

API er underlagt hastighetsbegrensninger, kun for å forhindre misbruk.

Du kan se grensen og forbruket i X-RateLimit-Limit og X-RateLimit-Remaining overskrifter.

Følgende biblioteker er tilgjengelige for bruk.

ACME-implementeringer

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-implementeringer

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

Endepunktene /ddns/ og /dyndns/ hjelper deg enkelt med å sette opp DDNS på et domene.

/dyndns/ emulerer strengt DynDns-protokollen, mens /ddns/ prøver å gi mer beskrivende svar og aksepterer flere argumenter.

Curl eksempel (Anbefalt)

Bruk følgende Curl-kommando for å sette home.example.com til den eksterne IP for den anmodende klient:

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

Du kan sette denne kommandoen til å kjøre i en crontab, på en lokal maskin, hvert 15. minutt eller deromkring.

Synology

På Synology kan du bruke følgende syntaks som Custom DDNS Provider

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

hostname skal deretter angis som det fullstendig kvalifiserte domenenavnet du ønsker å oppdatere, f.eks. 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

I UniFi OS må du sette opp en egendefinert dynamisk DNS-leverandør og skrive inn følgende streng i "Server"-feltet.

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