Documentazione API di Simply.com

Puoi trovare l'endpoint HTTP su https://api.simply.com/2/ - prefissa le tue richieste con questo.

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

L'autenticazione avviene inviando la chiave API dell'account specifico come token Bearer nell'header Authorization:

Authorization: Bearer APIKEY

Le chiavi API vengono create nel Pannello di controllo di Simply.com sotto Account, Chiavi API.

HTTP Basic Authentication con la chiave API come password funziona ancora, ma è deprecato. Le integrazioni dovrebbero passare al token Bearer.

Puoi trovare la documentazione API interattiva qui: https://api.simply.com/2/doc/

Oppure scarica la specifica OpenAPI in JSON: https://api.simply.com/2/doc.json

La versione 3 dell'API è in beta. Endpoint, campi e comportamenti possono ancora cambiare senza preavviso, quindi le integrazioni che richiedono stabilità dovrebbero continuare a usare la versione 2.

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

Puoi trovare la documentazione API interattiva qui: https://api.simply.com/3/doc/

Oppure scarica la specifica OpenAPI in JSON: https://api.simply.com/3/doc.json

L'API è soggetta a limiti di velocità, solo per prevenire abusi.

In caso di superamento, l'API risponde con 429 e indica il tempo di attesa in Retry-After.

Collega Claude, Cursor, Codex e altri assistenti AI a Simply.com tramite MCP. Modifica il DNS, cambia i nameserver, trova domini disponibili, crea account email e controlla i file di log, semplicemente chiedendo.

Leggi di più

Le seguenti librerie sono disponibili per l'uso.

Implementazioni 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

Router e client DDNS che supportano il protocollo DynDNS2 possono utilizzare direttamente l'host ddns.simply.com.

Per gli script e altre automazioni DNS consigliamo l'API REST, che può creare, modificare ed eliminare i record DNS.

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

L'autenticazione avviene con HTTP Basic Authentication, dove la password è la chiave API per l'account. Il nome utente può essere qualsiasi cosa, ad esempio il nome dell'account.

Se myip è escluso, viene utilizzato l'indirizzo IP da cui proviene la richiesta. Gli aggiornamenti devono avvenire tramite HTTPS.

Il record deve trovarsi nella zona DNS, prima di poter essere aggiornato: un record A per IPv4 e un record AAAA per IPv6. Se non esiste, viene restituito nohost, quindi crea prima il record nel pannello di controllo.

Il parametro domain indica il dominio. Deve essere inviato, quando il dominio stesso viene aggiornato, ad esempio hostname=example.com&domain=example.com, e può essere usato, quando il dominio non può essere dedotto da hostname.

Le risposte seguono il protocollo DynDNS2, ad esempio good per un aggiornamento e nochg, quando l'indirizzo IP non è cambiato.

L'indirizzo https://ddns.simply.com/myip restituisce l'indirizzo IP pubblico da cui proviene la richiesta e non richiede autenticazione.

ddclient

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

Esempio di Curl (Consigliato)

Usa il seguente comando Curl per impostare home.example.com all'indirizzo IP esterno del client richiedente:

curl -s -u "ACCOUNTNAME:APIKEY" "https://ddns.simply.com/nic/update?hostname=home.example.com"

Puoi impostare questo comando per essere eseguito in un crontab, su una macchina locale, ogni 15 minuti o giù di lì.

Synology

Su Synology puoi utilizzare la seguente sintassi come provider DDNS personalizzato

https://ddns.simply.com/nic/update?hostname=__HOSTNAME__&myip=__MYIP__

hostname deve quindi essere indicato come il nome di dominio completamente qualificato che desideri aggiornare, ad es. home.example.com.

Home Assistant

Il sensore recupera l'indirizzo IP pubblico ogni 5 minuti, e l'automazione aggiorna il DNS solo quando l'indirizzo cambia e quando Home Assistant si avvia. La chiave API viene salvata in 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

In UniFi OS, devi configurare un provider DNS dinamico personalizzato e inserire la seguente stringa nel campo "Server".

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