Simply.com is available in english
Switch language to english

Documentație API Simply.com

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

Documentație API interactivă
OpenAPI specificație

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.

Cheile API sunt create în panoul de control Simply.com sub Cont, Chei API.

Spec OpenAPI / Documentație

Poți găsi documentația API interactivă aici: https://api.simply.com/2/doc/

Sau descarcă specificația OpenAPI ca JSON: https://api.simply.com/2/doc.json

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