Simply.com API documentation

This document describes the Simply.com RESTful JSON API.

API endpoint

You can find the HTTP endpoint on https://api.simply.com/2/ - prefix your requests with this.

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

Authentication

Authentication happens with HTTP Basic Authentication.

Username is the Simply.com Account-number (Sxxxxxx) and the password is the API-Key for that specific account.

Both the Account-number and API-Key assigned to your Simply.com account can be found in your Simply.com Controlpanel.

OpenApi Spec / Documentation

You can find the OpenAPI spec for the API here: https://api.simply.com/2/openapi.json.

Consider using the Swagger UI browser here: https://generator.swagger.io/.

Examples

POST /ddns/ - DDNS helper

This endpoint helps you easily set up DDNS on a domain.

Curl example (Recommended)

Use the following Curl command to set home.example.com to the external IP of the requesting client:

curl -s -u "ACCOUNTNAME:APIKEY" -X POST "https://api.simply.com/2/ddns/?domain=example.com&hostname=home.example.com"

You can set this command to run in a crontab, on a local machine, every 15 minutes or so.

Synology

On Synology you can use the following syntax as Custom DDNS Provider

https://api.simply.com/2/ddns/?domain=example.com&hostname=__HOSTNAME__&myip=__MYIP__

hostname should then be provided as the full qualified domain name that you wish to update, i.e. home.example.com.

Home Assistant

# In configuration.yaml file
rest_command:
  simplycom_ddns:
    username: "ACCOUNTNAME"
    password: "APIKEY"
    url: "https://api.simply.com/2/ddns/?domain=example.com&hostname=home"
# Automation
alias: Simply.com DDNS
trigger:
- platform: time_pattern
minutes: "0"
seconds: "0"
action:
- service: rest_command.simplycom_ddns