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 | Успех | Адрес успешно привязан |