Este documento descreve a API JSON RESTful da Simply.com.
Pode encontrar o endpoint HTTP em https://api.simply.com/2/ - prefixe as suas solicitações com isto.
A autenticação é feita com HTTP Basic Authentication.
Nome de utilizador é o número de conta Simply.com (Sxxxxxx).
Palavra-passe é a chave API para a conta específica.
Tanto o número de conta como a chave API atribuídos à sua conta Simply.com podem ser encontrados no seu painel de controlo Simply.com.
Pode encontrar a especificação OpenAPI para a API aqui: https://api.simply.com/2/openapi.json .
Considere usar o navegador Swagger UI aqui: https://generator.swagger.io/ .
A API está sujeita a limites de taxa, apenas para prevenir abusos.
Pode ver o limite e o consumo em X-RateLimit-Limit e X-RateLimit-Remaining cabeçalhos.
Os seguintes bibliotecas estão disponíveis para 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/ |
|---|
Os endpoints /ddns/ e /dyndns/ ajuda-o a configurar facilmente o DDNS num domínio.
/dyndns/ emula estritamente o protocolo DynDns, enquanto /ddns/ tenta dar respostas mais descritivas e aceita mais argumentos.
Use o seguinte comando Curl para definir home.example.com para o IP externo do cliente solicitante:
curl -s -u "ACCOUNTNAME:APIKEY" "https://api.simply.com/2/ddns/?domain=example.com&hostname=home.example.com"
Pode configurar este comando para ser executado num crontab, numa máquina local, a cada 15 minutos ou por aí.
No Synology, pode usar a seguinte sintaxe como Provedor DDNS Personalizado
https://api.simply.com/2/dyndns/?hostname=__HOSTNAME__&myip=__MYIP__
hostname deve então ser especificado como o nome de domínio totalmente qualificado que deseja atualizar, por exemplo. 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
No UniFi OS, deves configurar um fornecedor de DNS Dinâmico Personalizado e inserir a seguinte string no campo "Servidor".
api.simply.com/2/dyndns/?hostname=%h&myip=%i