Simply.com is available in english
Switch language to english

Τεκμηρίωση API της Simply.com

Αυτό το έγγραφο περιγράφει το RESTful JSON API της Simply.com.

API v2

Διαδραστική τεκμηρίωση API OpenAPI προδιαγραφή

API v3 Beta

Διαδραστική τεκμηρίωση API OpenAPI προδιαγραφή

API τελικό σημείο

Μπορείτε να βρείτε το HTTP endpoint στο https://api.simply.com/2/ - Προσθέστε αυτό ως πρόθεμα στα ερωτήματά σας.

Παράδειγμα: https://api.simply.com/2/my/products/

Πιστοποίηση

Ο έλεγχος ταυτότητας πραγματοποιείται με την αποστολή του κλειδιού API για τον συγκεκριμένο λογαριασμό ως Bearer token στην κεφαλίδα Authorization:

Authorization: Bearer APIKEY

API-κλειδιά δημιουργούνται στον Πίνακα Ελέγχου του Simply.com, στην ενότητα Λογαριασμός, API-κλειδιά.

Το HTTP Basic Authentication με το κλειδί API ως κωδικό πρόσβασης εξακολουθεί να λειτουργεί, αλλά έχει καταργηθεί. Οι ενσωματώσεις θα πρέπει να μεταβούν σε Bearer token.

OpenApi Spec / Τεκμηρίωση

Μπορείτε να βρείτε την διαδραστική τεκμηρίωση API εδώ: https://api.simply.com/2/doc/

Ή κατεβάστε την προδιαγραφή OpenAPI ως JSON: https://api.simply.com/2/doc.json

API v3 Beta

Η έκδοση 3 του API βρίσκεται σε beta. Τα endpoints, τα πεδία και η συμπεριφορά ενδέχεται να αλλάξουν ακόμη χωρίς προειδοποίηση, οπότε οι ενσωματώσεις που απαιτούν σταθερότητα θα πρέπει να συνεχίσουν να χρησιμοποιούν την έκδοση 2.

Endpoint: https://api.simply.com/3/

Μπορείτε να βρείτε την διαδραστική τεκμηρίωση API εδώ: https://api.simply.com/3/doc/

Ή κατεβάστε την προδιαγραφή OpenAPI ως JSON: https://api.simply.com/3/doc.json

Όρια ρυθμού

Το API υπόκειται σε περιορισμούς ταχύτητας, μόνο για την πρόληψη κατάχρησης.

Σε περίπτωση υπέρβασης, το API απαντά με 429 και υποδεικνύει τον χρόνο αναμονής στο Retry-After.

Simply.com AI Connector (MCP)

Συνδέστε το Claude, το Cursor, το Codex και άλλους AI βοηθούς με το Simply.com μέσω MCP. Τροποποιήστε το DNS, αλλάξτε nameservers, βρείτε διαθέσιμα domains, δημιουργήστε λογαριασμούς email και ελέγξτε τα αρχεία καταγραφής, απλώς ρωτώντας.

Διαβάστε περισσότερα

Υλοποιήσεις βιβλιοθηκών

Οι παρακάτω βιβλιοθήκες είναι διαθέσιμες για χρήση.

Υλοποιήσεις ACME

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

ddns.simply.com (DynDNS2)

Δρομολογητές και πελάτες DDNS που υποστηρίζουν το πρωτόκολλο DynDNS2, μπορούν να χρησιμοποιήσουν τον διακομιστή ddns.simply.com απευθείας.

Για scripts και άλλη αυτοματοποίηση του DNS προτείνουμε το REST API, το οποίο μπορεί να δημιουργήσει, να τροποποιήσει και να διαγράψει DNS-records.

https://ddns.simply.com/nic/update?hostname=home.example.com&domain=example.com&myip=1.2.3.4

Η ταυτοποίηση γίνεται με HTTP Basic Authentication, όπου ο κωδικός πρόσβασης είναι το κλειδί API του λογαριασμού. Το όνομα χρήστη μπορεί να είναι οτιδήποτε, π.χ. το όνομα λογαριασμού.

Αν παραλειφθεί το myip, χρησιμοποιείται η διεύθυνση IP από την οποία προέρχεται το αίτημα. Οι ενημερώσεις πρέπει να γίνονται μέσω HTTPS.

Η εγγραφή πρέπει να βρεθεί στη ζώνη DNS, πριν μπορέσει να ενημερωθεί: μια A-record για IPv4 και μια AAAA-record για IPv6. Αν δεν υπάρχει, επιστρέφεται nohost, οπότε δημιουργήστε την εγγραφή πρώτα στον πίνακα ελέγχου.

Η παράμετρος domain υποδεικνύει το domain. Πρέπει να συμπεριλαμβάνεται όταν το ίδιο το domain ενημερώνεται, π.χ. hostname=example.com&domain=example.com, και μπορεί να χρησιμοποιηθεί όταν το domain δεν μπορεί να εξαχθεί από το hostname.

Οι απαντήσεις ακολουθούν το πρωτόκολλο DynDNS2, π.χ. good κατά την ενημέρωση και nochg, όταν η IP διεύθυνση είναι αμετάβλητη.

Η διεύθυνση https://ddns.simply.com/myip επιστρέφει τη δημόσια διεύθυνση IP, από την οποία προέρχεται το αίτημα, και δεν απαιτεί έλεγχο ταυτότητας.

ddclient

protocol=dyndns2
ssl=yes
server=ddns.simply.com
login=ACCOUNTNAME
password=APIKEY
home.example.com

Παράδειγμα cURL (Προτεινόμενο)

Χρησιμοποιήστε την παρακάτω εντολή Curl για να ορίσετε home.example.com στην εξωτερική IP για τον αιτούντα πελάτη: 

curl -s -u "ACCOUNTNAME:APIKEY" "https://ddns.simply.com/nic/update?hostname=home.example.com"

Μπορείτε να ρυθμίσετε αυτήν την εντολή να τρέχει σε ένα crontab, σε ένα τοπικό μηχάνημα, κάθε 15 λεπτά ή περίπου.

Synology

Στο Synology μπορείτε να χρησιμοποιήσετε την παρακάτω σύνταξη ως προσαρμοσμένο πάροχο DDNS

https://ddns.simply.com/nic/update?hostname=__HOSTNAME__&myip=__MYIP__

hostname θα πρέπει στη συνέχεια να δοθεί ως το πλήρες προσδιορισμένο όνομα τομέα, το οποίο θέλετε να ενημερώσετε, π.χ. home.example.com.

Home Assistant

Ο αισθητήρας ανακτά τη δημόσια διεύθυνση IP κάθε 5 λεπτά και η αυτοματοποίηση ενημερώνει το DNS μόνο όταν η διεύθυνση αλλάζει και όταν ξεκινά το Home Assistant. Το κλειδί API αποθηκεύεται στο secrets.yaml.

# configuration.yaml
sensor:
  - platform: rest
    name: Public IP
    resource: https://ddns.simply.com/myip
    value_template: "{{ value | trim }}"
    scan_interval: 300

rest_command:
  simplycom_ddns:
    url: "https://ddns.simply.com/nic/update?hostname=home.example.com"
    username: "ACCOUNTNAME"
    password: !secret simply_api_key
# secrets.yaml
simply_api_key: "APIKEY"
# Automation
alias: Simply.com DDNS
triggers:
  - trigger: state
    entity_id: sensor.public_ip
  - trigger: homeassistant
    event: start
actions:
  - action: rest_command.simplycom_ddns

Unifi

Στο UniFi OS πρέπει να ρυθμίσετε έναν προσαρμοσμένο πάροχο Dynamic DNS και να εισαγάγετε την ακόλουθη συμβολοσειρά στο πεδίο "Server".

ddns.simply.com/nic/update?hostname=%h&myip=%i