API обновления динамического IP адреса
Для того что бы обновить ваш привязанный в системе динамический IP адрес необходимо отправить HTTP запрос на следующий URL:
https://www.skydns.ru/nic/update
Пример минимального запроса с передачей авторизационных данных в запросе в явном виде (поддерживается роутерами с прошивкой DD-WRT, OPEN-WRT и другими системами)
https://username:password@www.skydns.ru/nic/update?hostname=home
Пример сырого HTTP запроса с передачей авторизационных данных в закодированном виде
GET /nic/update?hostname=home HTTP/1.0
Host: www.skydns.ru
Authorization: Basic base64-encoded-auth-string
Авторизация при использовании сырых HTTP запросов
Для сырых HTTP запросов нужно использовать Basic Authorization.
Нужно передавать специальный HTTP заголовок Authorization в каждом запросе, в котором передавать строку username:password, закодированную методом base64. При этом следует явно указывать базовый (Basic) метод авторизации.
Пример заголовка:
Authorization: Basic NDc2MDE4N2Q4MWJjNGI3Nzk5NDc2YjQycjUxMDM3MTM6ZjI1YmViZjk5MWZmNDE5ODkzZGIyNTU3MjhlNGUxZGU=
Параметры URL
Поле | Обязательный | Описание |
---|---|---|
username:password | Да | Логин и пароль аккаунта. В качестве логина используется email адрес. |
hostname | Да | Указывает имя хоста, добавляется для идентификации. Например, если привязывается несколько IP адресов на один профиль. |
profile | Нет | Указывает числовой идентификатор профиля на который будет привязан IP адрес. Идентификаторы можно увидеть в личном кабинете в разделе Профили. |
myip | Нет | Обновляемый динамический IP адрес. В целях безопасности данный параметр игнорируется и обновляемый адрес берется не из параметра, а определяется на стороне нашего сервера. |
Коды ответа
Код | Статус | Описание |
---|---|---|
Authentication required | Ошибка | Требуется авторизация, указаны неправильные данные в заголовке Authorization |
badprofile | Ошибка | Указан неверный профиль |
!yours | Ошибка | Данный IP адрес уже используется, для большей информации можете посмотреть статус в кабинете |
good IP_ADDRESS | Успех | Адрес успешно привязан |