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).

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.

Rate limits

The API is subject to rate limits, only to prevent abuse.

You can see the limit and the consumption in the X-RateLimit-Limit and X-RateLimit-Remaining headers.

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