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.
Tanto el número de cuenta como la clave API asignados a tu cuenta de Simply.com se pueden encontrar en tu Panel de Control de Simply.com.
Puedes encontrar la especificación de OpenAPI para la API aquí: https://api.simply.com/2/openapi.json .
Considere usar el navegador Swagger UI aquí: https://generator.swagger.io/ .
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