Documentație API Simply.com

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/

Autentificarea se realizează prin trimiterea cheii API pentru contul specific ca token Bearer în antetul Authorization:

Authorization: Bearer APIKEY

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

HTTP Basic Authentication cu cheia API ca parolă funcționează încă, dar este perimată. Integrările ar trebui să treacă la token Bearer.

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

Versiunea 3 a API-ului este în beta. Endpoint-urile, câmpurile și comportamentul se pot modifica în continuare fără avertisment, așa că integrările care necesită stabilitate ar trebui să folosească în continuare versiunea 2.

Endpoint: https://api.simply.com/3/

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

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

API este supus limitelor de rată, doar pentru a preveni abuzul.

În caz de depășire API răspunde cu 429 și indică timpul de așteptare în Retry-After.

Conectați Claude, Cursor, Codex și alți asistenți AI la Simply.com prin MCP. Corectați DNS, schimbați nameserverele, găsiți domenii disponibile, creați conturi de email și verificați fișierele log, doar întrebând.

Citește mai mult

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

Routere și clienți DDNS care suportă protocolul DynDNS2 pot folosi direct gazda ddns.simply.com.

Pentru scripturi și alte automatizări ale DNS recomandăm API-ul REST, care poate crea, modifica și șterge înregistrările DNS.

https://ddns.simply.com/nic/update?hostname=home.example.com&domain=example.com&myip=1.2.3.4

Autentificarea se face cu HTTP Basic Authentication, unde parola este cheia API a contului. Numele de utilizator poate fi orice, de exemplu numele contului.

Dacă se exclude myip, se folosește adresa IP de la care provine cererea. Actualizările trebuie să se facă prin HTTPS.

Înregistrarea trebuie să fie găsită în zona DNS, înainte de a putea fi actualizată: un A-record pentru IPv4 și un AAAA-record pentru IPv6. Dacă nu există, se răspunde cu nohost, așa că creați mai întâi înregistrarea în panoul de control.

Parametrul domain indică domeniul. Acesta trebuie să fie trimis, când domeniul în sine este actualizat, de exemplu hostname=example.com&domain=example.com, și poate fi folosit când domeniul nu poate fi dedus din hostname.

Răspunsurile urmează protocolul DynDNS2, de exemplu good la o actualizare și nochg, când adresa IP este neschimbată.

Adresa https://ddns.simply.com/myip returnează adresa IP publică de la care provine cererea și nu necesită autentificare.

ddclient

protocol=dyndns2
ssl=yes
server=ddns.simply.com
login=ACCOUNTNAME
password=APIKEY
home.example.com

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://ddns.simply.com/nic/update?hostname=home.example.com"

Poți seta această comandă să ruleze într-un crontab, pe o mașină locală, la fiecare 15 minute sau cam așa.

Synology

Pe Synology poţi folosi următoarea sintaxă ca furnizor DDNS personalizat

https://ddns.simply.com/nic/update?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

Senzorul preia adresa IP publică la fiecare 5 minute, și automatizarea actualizează DNS doar când adresa se modifică și când Home Assistant pornește. Cheia API este salvată în secrets.yaml.

# configuration.yaml
sensor:
  - platform: rest
    name: Public IP
    resource: https://ddns.simply.com/myip
    value_template: "{{ value | trim }}"
    scan_interval: 300

rest_command:
  simplycom_ddns:
    url: "https://ddns.simply.com/nic/update?hostname=home.example.com"
    username: "ACCOUNTNAME"
    password: !secret simply_api_key

# secrets.yaml
simply_api_key: "APIKEY"

# Automation
alias: Simply.com DDNS
triggers:
  - trigger: state
    entity_id: sensor.public_ip
  - trigger: homeassistant
    event: start
actions:
  - action: 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”.

ddns.simply.com/nic/update?hostname=%h&myip=%i