Este documento describe la API JSON RESTful de Simply.com.
Puedes encontrar el endpoint HTTP en https://api.simply.com/2/ - prefija tus solicitudes con esto.
La autenticación se realiza con HTTP Basic Authentication.
Nombre de usuario es el número de cuenta de Simply.com (Sxxxxxx).
Código de acceso es la clave API para la cuenta específica.
Las claves API se crean en el panel de control de Simply.com bajo Cuenta, Claves API.
Puedes encontrar la documentación interactiva de la API aquí: https://api.simply.com/2/doc/
O descarga la especificación OpenAPI como JSON: https://api.simply.com/2/doc.json
La API está sujeta a límites de tasa, solo para prevenir el abuso.
Puedes ver el límite y el consumo en X-RateLimit-Limit y X-RateLimit-Remaining encabezados.
Los siguientes bibliotecas están disponibles para su uso.
| 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 |
| PHP | https://github.com/simplycom/api-php/ |
|---|
Los puntos finales /ddns/ y /dyndns/ te ayuda fácilmente a configurar DDNS en un dominio.
/dyndns/ emula estrictamente el protocolo DynDns, mientras /ddns/ intentando dar respuestas más descriptivas y aceptar más argumentos.
Utiliza el siguiente comando Curl para establecer home.example.com a la IP externa del cliente solicitante:
curl -s -u "ACCOUNTNAME:APIKEY" "https://api.simply.com/2/ddns/?domain=example.com&hostname=home.example.com"
Puedes configurar este comando para que se ejecute en un crontab, en una máquina local, cada 15 minutos o algo así.
En Synology, puedes usar la siguiente sintaxis como proveedor DDNS personalizado.
https://api.simply.com/2/dyndns/?hostname=__HOSTNAME__&myip=__MYIP__
hostname debe indicarse como el nombre de dominio completo calificado que desea actualizar, p. ej. home.example.com.
# 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
En UniFi OS, debes configurar un proveedor de DNS dinámico personalizado e ingresar la siguiente cadena en el campo "Servidor".
api.simply.com/2/dyndns/?hostname=%h&myip=%i