# 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

<table border="1" id="bkmrk-%D0%9F%D0%BE%D0%BB%D0%B5-%D0%9E%D0%B1%D1%8F%D0%B7%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B9-%D0%9E%D0%BF" style="border-collapse: collapse; width: 100%;"><tbody><tr><th style="width: 33.3663%;">Поле</th><th style="width: 33.3663%;">Обязательный</th><th style="width: 33.3663%;">Описание</th></tr><tr><td style="width: 33.3663%;">username:password</td><td style="width: 33.3663%;">Да</td><td style="width: 33.3663%;">Логин и пароль аккаунта. В качестве логина используется email адрес.</td></tr><tr><td style="width: 33.3663%;">hostname</td><td style="width: 33.3663%;">Да</td><td style="width: 33.3663%;">Указывает имя хоста, добавляется для идентификации. Например, если привязывается несколько IP адресов на один профиль.</td></tr><tr><td style="width: 33.3663%;">profile</td><td style="width: 33.3663%;">Нет</td><td style="width: 33.3663%;">Указывает числовой идентификатор профиля на который будет привязан IP адрес. Идентификаторы можно увидеть в личном кабинете в разделе Профили.</td></tr><tr><td style="width: 33.3663%;">myip</td><td style="width: 33.3663%;">Нет</td><td style="width: 33.3663%;">Обновляемый динамический IP адрес. В целях безопасности данный параметр игнорируется и обновляемый адрес берется не из параметра, а определяется на стороне нашего сервера.</td></tr></tbody></table>

Коды ответа

<table border="1" id="bkmrk-%D0%9A%D0%BE%D0%B4-%D0%A1%D1%82%D0%B0%D1%82%D1%83%D1%81-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-" style="border-collapse: collapse; width: 100%;"><tbody><tr><th style="width: 33.3663%;">Код</th><th style="width: 33.3663%;">Статус</th><th style="width: 33.3663%;">Описание</th></tr><tr><td style="width: 33.3663%;">Authentication required</td><td style="width: 33.3663%;"><span class="text-error">Ошибка</span></td><td style="width: 33.3663%;">Требуется авторизация, указаны неправильные данные в заголовке Authorization</td></tr><tr><td style="width: 33.3663%;">badprofile</td><td style="width: 33.3663%;">Ошибка</td><td style="width: 33.3663%;">Указан неверный профиль</td></tr><tr><td style="width: 33.3663%;">!yours</td><td style="width: 33.3663%;">Ошибка</td><td style="width: 33.3663%;">Данный IP адрес уже используется, для большей информации можете посмотреть статус в [кабинете](https://www.skydns.ru/cabinet/devices/)</td></tr><tr><td style="width: 33.3663%;">good IP\_ADDRESS</td><td style="width: 33.3663%;">Успех</td><td style="width: 33.3663%;">Адрес успешно привязан</td></tr></tbody></table>