VPN без ограничения скорости для Android, iOS, Windows, macOSПодробнее

СЕРВЕРЫ

ИНСТРУКЦИИ ДЛЯ СЕРВЕРОВ

Управление доменами

Добавление домена в панель

POST /v1/accounts/{login}/domains/{domain}/nameserver

Шаблон запроса

curl -X POST "https://api.timeweb.ru/v1/accounts/{login}/domains/{domain}/nameserver" \
-H "accept: application/json" \
-H "x-app-key: {appkey}" \
-H "Authorization: Bearer {token}"

Добавление поддомена в панель

POST /v1.1/accounts/{login}/domains/{domain}/subdomains/{subdomain}

Шаблон запроса

curl -X POST "https://api.timeweb.ru/v1.1/accounts/{login}/domains/{domain}/subdomains/{subdomain}" \
-H "accept: */*" \
-H "x-app-key: {appkey}" \
-H "Authorization: Bearer {token}"

Получение ID персоны администратора домена

GET /v3/accounts/{login}/persons

Шаблон запроса

curl -X GET "https://api.timeweb.ru/v3/accounts/{login}/persons" \
-H "accept: application/json" \
-H "x-app-key: {appkey}" \
-H "Authorization: Bearer {token}"

Пример ответа

"address": "Россия, Санкт-Петербург, ул.Заставская дом 22 А",
  "birthdate": "1990-01-01",
  "country_code": "",
  "document_id": "1234",
  "email": "mail@example.ru",
  "fax": "",
  "id": 123456,
  "is_closed": false,
  "name_eng": "Ivanov Ivan Ivanovich",
  "name_rus": "Иванов Иван Иванович",
  "passport_date": "2010-01-01",
  "passport_number": "567890",
  "passport_place": "ТП N123 ОУФМС России по СПб и Лен. обл",
  "passport_series": "1234",
  "phone": "+7 (999) 123-45-67",
  "postcode": "196006",
  "resident": "Y",
  "type": "person"

Создание заявки на регистрацию домена

POST /v1.1/domains/request

Шаблон запроса

curl -v -X POST "https://api.timeweb.ru/v1.1/domains/request" \
-H "accept: */*" \
-H "x-app-key: {appkey}" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d "{\"action\":\"register\", \
\"autoprolong\":false, \
\"fqdn\":\"{domain}\", \
\"person_id\":1, \
\"whois_privacy\":false}"

Параметры:

  • autoprolong — включение опции автопродления, true / false.
  • fqdn — домен, который вы хотите зарегистрировать.
  • person_id — ID администратора домена, на чьи данные будет зарегистрирован домен (ID можно получить из запроса выше).
  • whois_privacy — включение опции скрытия данных администратора домена, true / false.

В ответе на запрос будет указан ID заявки на регистрацию в заголовке Location, например:

location: https://api.timeweb.ru/v1.1/domains/request/123456

В данном случае ID — 123456. ID заявки необходим для запроса на оплату регистрации (метод ниже).

Оплата регистрации с баланса аккаунта

PUT /v1.1/domains/request/{id}

Шаблон запроса

curl -X PUT "https://api.timeweb.ru/v1.1/domains/request/{id}" \
-H "accept: */*" \
-H "x-app-key: {appkey}" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d "{\"person_id\":1, \
\"auth_code\":\"abcdefghij\", \
\"money_source\":\"use\"}"

Параметры:

  • id — ID заявки на регистрацию, берется из запроса выше.
  • person_id — ID администратора домена, на чьи данные будет зарегистрирован домен.

Параметр money_source определяет способ оплаты: при указании use заявка будет оплачена с баланса аккаунта.

Добавление ресурсной записи для домена

POST /v1.2/accounts/{login}/domains/{domain}/user-records/

Шаблон запроса

curl -X POST "https://api.timeweb.ru/v1.2/accounts/{login}/domains/{domain}/user-records/" \
-H "accept: */*" \
-H "x-app-key: {appkey}" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d "{\"data\": \
{\"host\":\"mail.server.com\", \
\"port\":443, \
\"priority\":10, \
\"protocol\":\"_TCP\", \
\"service\":\"_sip\"}, \
\"type\":\"SRV\"}"

Параметры port, priority, protocol, service могут быть удалены из запроса, если не требуются.

Получение ресурсных записей домена

GET /v1.2/accounts/{login}/domains/{domain}/user-records

Шаблон запроса

Запрос по умолчанию, выдаст 10 ресурсных записей:

curl -X GET "https://api.timeweb.ru/v1.2/accounts/{login}/domains/{domain}/user-records" \
-H "accept: */*" \
-H "x-app-key: {appkey}" \
-H "Authorization: Bearer {token}"

Для выдачи большего количества используйте параметр limit:

curl -X GET "https://api.timeweb.ru/v1.2/accounts/{login}/domains/{domain}/user-records?limit=100" \
-H "accept: */*" \
-H "x-app-key: {appkey}" \
-H "Authorization: Bearer {token}"

Для удобства дополнительно можно использовать offset:

curl -X GET "https://api.timeweb.ru/v1.2/accounts/{login}/domains/{domain}/user-records?limit=100&offset=20" \
-H "accept: */*" \
-H "x-app-key: {appkey}" \
-H "Authorization: Bearer {token}"

Пример ответа

{
  "data": {
    "subdomain": "test",
    "value": "v=spf1 ip4:176.57.223.0/24 ip4:92.53.116.0/22 ip6:2a03:6f00::/32 ~all"
  },
  "id": 29044587,
  "type": "TXT"
},
{
  "data": {
    "value": "193.164.150.42"
  },
  "id": 29044532,
  "type": "A"
},
{
  "data": {
    "priority": 20,
    "value": "mx2.timeweb.ru"
  },
  "id": 29044498,
  "type": "MX"
},
{
  "data": {
    "priority": 10,
    "value": "mx1.timeweb.ru"
  },
  "id": 29044497,
  "type": "MX"
},
{
  "data": {
    "subdomain": null,
    "value": "v=spf1 ip4:176.57.223.0/24 ip4:92.53.116.0/22 ip6:2a03:6f00::/32 ~all"
  },
  "id": 29044494,
  "type": "TXT"
}

ID ресурсной записи, полученный в данном запросе (например: "id": 29044494), используется для удаления записей.

Удаление ресурсной записи

DELETE /v1.2/accounts/{login}/domains/{domain}/user-records/{idrecords}/

Шаблон запроса

curl -X DELETE "https://api.timeweb.ru/v1.2/accounts/{login}/domains/{domain}/user-records/{idrecords}/" \
-H "accept: */*" \
-H "x-app-key: {appkey}" \
-H "Authorization: Bearer {token}"

ID записи (параметр idrecords) можно получить из метода выше.

15 лет опыта
Сосредоточьтесь на своей работе: об остальном позаботимся мы
165 000 клиентов
Нам доверяют частные лица и компании, от небольших фирм до корпораций
Поддержка 24/7
100+ специалистов поддержки, готовых помочь в чате, тикете и по телефону