Simply.com is available in english

Documentație API Simply.com

Acest document descrie API-ul RESTful JSON al Simply.com.

endpoint API

Poți găsi endpoint‑ul HTTP la https://api.simply.com/2/ - prefixează-ți interogările cu acesta.

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

Autentificare

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.

Spec OpenAPI / Documentație

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/ .

Limite de rată

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.

Implementări de bibliotecă

Următoarele biblioteci sunt disponibile pentru utilizare.

ACME implementări

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

Implementări API

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

Exemple

DNS dinamic ajută

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.

Exemplu Curl (Recomandat)

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.

Synology

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.

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

Î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