Использование API

Некоторые функции сайта доступны через API. Для запросов требуется API_KEY, который можно получить в личном кабинете после регистрации.

Для авторизации GET к запросу добавляется параметр `?apikey=[API_KEY]`.
Для POST-запросов параметр `apikey` добавляется в POST.

Ответы API

В случае успешного завершения возвращается ответ в JSON. В случае ошибок в параметрах запроса, описание ошибки будет возвращено в поле `error`.

Код HTTP Описание
200 Ответ получен
403 Нет доступа: не указан `API_KEY` или недостаточно прав для функции которую вы запросили.
5xx Ошибка сервера. Что-то пошло не так, мы уведомлены об ошибке и скоро ее исправим.

Аккаунт

Баланс

URL: /api/account/balance
Метод запроса: GET
Пример запроса:
import requests

requests.get("https://fornex.com/api/account/balance", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/account/balance" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "balance": 91.0,
  "currency": "EUR"
}

Информация

URL: /api/account/info
Метод запроса: GET
Пример запроса:
import requests

requests.get("https://fornex.com/api/account/info", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/account/info" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "email": "example@fornex.com",
  "name": "Example Account"
}

Счета

URL: /api/account/invoices
Метод запроса: GET
Пример запроса:
import requests

requests.get("https://fornex.com/api/account/invoices", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/account/invoices" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "unpaid_invoices_count": 1,
  "unpaid_invoices_amount": 100,
  "currency": "EUR"
}

Заказы

Список заказов

URL: /api/orders/list
Метод запроса: GET
Пример запроса:
import requests

requests.get("https://fornex.com/api/orders/list", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/orders/list" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
[
  {
    "cost_month": 148.0,
    "expiration_date": "2015-12-18T17:21:46",
    "id": "34-1234",
    "ipaddress_set": [
      "123.123.123.123"
    ],
    "name": "user-defined-name",
    "hostname": "srv-123.fornex.org",
    "status": "active",
    "tariff": "VPS Master",
    "tariff_id": 33,
    "tariff_price": 140,
    "type": "vps"
  }
]

Тарифы

VPN

URL: /api/plans/vpn
Метод запроса: GET
Пример запроса:
import requests

requests.get("https://fornex.com/api/plans/vpn", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/plans/vpn" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
[
  {
    "available_locations": [
      "DE",
      "NL",
      "US",
      "RU"
    ],
    "type": "dedicated",
    "id": 1,
    "price": 10.0
  }
]

Бэкапы

URL: /api/plans/backups
Метод запроса: GET
Пример запроса:
import requests

requests.get("https://fornex.com/api/plans/backups", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/plans/backups" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
[
  {
    "price": 3.0,
    "space": 100,
    "units": "Gb"
  },
  {
    "price": 4.5,
    "space": 150,
    "units": "Gb"
  },
  {
    "price": 6.0,
    "space": 200,
    "units": "Gb"
  }
]

Виртуальные сервера

URL: /api/plans/vps
Метод запроса: GET
Пример запроса:
import requests

requests.get("https://fornex.com/api/plans/vps", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/plans/vps" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
[
  {
    "bandwidth": "100 Мбит/сек",
    "cpu_count": 1,
    "disk": "10 ГБ",
    "id": 433,
    "name": "SSD Cloud 1GB",
    "price": 5.0,
    "ram": "1 ГБ"
  }
]

Выделенные сервера

URL: /api/plans/dedicated
Метод запроса: GET
Пример запроса:
import requests

requests.get("https://fornex.com/api/plans/dedicated", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/plans/dedicated" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
[
  {
    "bandwidth": "1 Гбит/сек",
    "cpu_model": "Intel Xeon E3-1270 (4×3.4Ghz)",
    "cpu_count": 1,
    "disk": "4 × 300 ГБ SAS 15k",
    "name": "DS XeonSAS",
    "id": 101,
    "price": 198.0,
    "ram": "16 ГБ",
    "location": "DE"
  }
]

Хостинг

URL: /api/plans/hosting
Метод запроса: GET
Пример запроса:
import requests

requests.get("https://fornex.com/api/plans/hosting", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/plans/hosting" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
[
  {
    "available_locations": [
      "DE",
      "RU"
    ],
    "cpu_cores": 1,
    "databases": 2,
    "hdd_space": 1000,
    "mail_domains": 2,
    "mailboxes": 20,
    "name": "VH-SSD-2",
    "id": 33,
    "price": 1.0,
    "sites": 2
  }
]

VPS

Hard reset

URL: /api/vps/hard_reset/[order_id]/
Метод запроса: POST
Параметры URL:

  • order_id - номер заказа

Пример запроса:
import requests

requests.post("https://fornex.com/api/vps/hard_reset/34-177054/", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/vps/hard_reset/34-177054/" \
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "ok": "True"
}
Дополнительно:

Поле `ok` ответа содержит статус выполнения команды.

Включить

URL: /api/vps/start/[order_id]/
Метод запроса: POST
Параметры URL:

  • order_id - номер заказа

Пример запроса:
import requests

requests.post("https://fornex.com/api/vps/start/34-177054/", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/vps/start/34-177054/" \
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "ok": "True"
}
Дополнительно:

Поле `ok` ответа содержит статус выполнения команды.

Выключить

URL: /api/vps/stop/[order_id]/
Метод запроса: POST
Параметры URL:

  • order_id - номер заказа

Пример запроса:
import requests

requests.post("https://fornex.com/api/vps/stop/34-177054/", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/vps/stop/34-177054/" \
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "ok": "True"
}
Дополнительно:

Поле `ok` ответа содержит статус выполнения команды.

Детали выполнения команды

URL: /api/vps/log_details/[order_id]/
Метод запроса: GET
Параметры URL:

  • order_id - номер заказа

Параметры запроса:

  • log_id - id записи

Пример запроса:
import requests

requests.get("https://fornex.com/api/vps/log_details/34-1234/", {  
  "log_id": 222287,
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/vps/log_details/34-1234/" --get\
  --data "log_id=222287&apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "action": "Установка пароля root",
  "completed": false,
  "job_action": "set_root_passwd",
  "job_state": "ready",
  "note": "Выполняется сброс пароля root",
  "pk": 222287,
  "time": "03.01.2019 11:10",
  "user": "username"
}

Перезагрузить

URL: /api/vps/restart/[order_id]/
Метод запроса: POST
Параметры URL:

  • order_id - номер заказа

Пример запроса:
import requests

requests.post("https://fornex.com/api/vps/restart/34-177054/", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/vps/restart/34-177054/" \
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "ok": "True"
}
Дополнительно:

Поле `ok` ответа содержит статус выполнения команды.

Сбросить пароль root

URL: /api/vps/passwd_reset/[order_id]/
Метод запроса: GET
Параметры URL:

  • order_id - номер заказа

Пример запроса:
import requests

requests.get("https://fornex.com/api/vps/passwd_reset/34-177054/", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/vps/passwd_reset/34-177054/" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "resp_id": 1234,
  "passwd": "newstrongpassword"
}
Дополнительно:

`passwd` - ваш новый пароль.
`resp_id` - id команды в истории, по которой можно проверить статус выполнения, см vps_log_details

Статистика

URL: /api/vps_stat/[order_id]/[field]/[start]--[end].json
Метод запроса: GET
Параметры URL:

  • order_id - номер заказа
  • field - поле статистики [`cpu`|`memory`|`traffic`|`disk`|`inodes`|`io`]
  • start - дата начала
  • end - дата конца

Пример запроса:
import requests

requests.get("https://fornex.com/api/vps_stat/34-177054/traffic/2015-11-16--2015-11-17.json", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/vps_stat/34-177054/traffic/2015-11-16--2015-11-17.json" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "series": [
    {
      "color": "#60B5FF",
      "data": [
        61410.9215552,
        65379.49276,
        67115.7455904
      ],
      "name": "Входящий",
      "pointEnd": 1447773600000,
      "pointInterval": 300000,
      "pointStart": 1447687200000
    },
    {
      "color": "#61D561",
      "data": [
        4585.92634648,
        4575.14841552,
        4636.41519648
      ],
      "name": "Исходящий",
      "pointEnd": 1447773600000,
      "pointInterval": 300000,
      "pointStart": 1447687200000,
      "type": "areaspline"
    }
  ],
  "subtitle": "16 ноября 2015, 17:18 - 17 ноября 2015, 17:18 (Europe/Moscow)"
}
Дополнительно:

Поле `series` ответа структурированно в формате для Highcharts, параметры `pointStart`, `pointEnd`, указывают начало и конец в формате `unixtime * 1000`, `pointInterval` - интервал между значениями в поле data.

Статус

URL: /api/vps/status/[order_id]/
Метод запроса: GET
Параметры URL:

  • order_id - номер заказа

Пример запроса:
import requests

requests.get("https://fornex.com/api/vps/status/34-177054/", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/vps/status/34-177054/" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "status": "off"
}
Дополнительно:

Поле `status` ответа содержит статус VPS.

SSH

Добавить ключ

URL: /api/ssh_keys/add/
Метод запроса: POST
Параметры запроса:

  • title - название ключа
  • key - ключ

Пример запроса:
import requests

requests.post("https://fornex.com/api/ssh_keys/add/", {  
  "title": "test key",
  "key": "ssh-rsa tt3BPrBTUCasdasdGXsCXmiF03LD/f9 test@test",
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/ssh_keys/add/" \
  --data "title=test+key&key=ssh-rsa+tt3BPrBTUCasdasdGXsCXmiF03LD%2Ff9+test%40test&apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "date": "19 декабря 2017 г.",
  "id": 67,
  "key": "ssh-rsa tt3BPrBTUCGXsCXmiF03LD/f9 test@test",
  "title": "test@test"
}

Добавить ключ к заказу

URL: /api/ssh_keys/[order_id]/add/
Метод запроса: POST
Параметры URL:

  • order_id - номер заказа

Параметры запроса:

  • key_pk - id ключа

Пример запроса:
import requests

requests.post("https://fornex.com/api/ssh_keys/34-177054/add/", {  
  "key_pk": "99",
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/ssh_keys/34-177054/add/" \
  --data "key_pk=99&apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "ok": true
}

Список ключей заказа

URL: /api/ssh_keys/[order_id]/
Метод запроса: GET
Параметры URL:

  • order_id - номер заказа

Пример запроса:
import requests

requests.get("https://fornex.com/api/ssh_keys/34-177054/", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/ssh_keys/34-177054/" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
[
  {
    "date": "19 декабря 2017 г.",
    "id": 67,
    "key": "ssh-rsa tt3BPrBTUCGXsCXmiF03LD/f9 test@test",
    "title": "test@test"
  }
]

Список ключей пользователя

URL: /api/ssh_keys/
Метод запроса: GET
Пример запроса:
import requests

requests.get("https://fornex.com/api/ssh_keys/", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/ssh_keys/" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
[
  {
    "date": "19 декабря 2017 г.",
    "id": 67,
    "key": "ssh-rsa tt3BPrBTUCGXsCXmiF03LD/f9 test@test",
    "title": "test@test"
  }
]

Удалить ключ

URL: /api/ssh_keys/delete/
Метод запроса: POST
Параметры запроса:

  • key_pk - id ключа

Пример запроса:
import requests

requests.post("https://fornex.com/api/ssh_keys/delete/", {  
  "key_pk": "74",
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/ssh_keys/delete/" \
  --data "key_pk=74&apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "ok": true
}

Удалить ключ заказа

URL: /api/ssh_keys/[order_id]/delete/
Метод запроса: POST
Параметры URL:

  • order_id - номер заказа

Параметры запроса:

  • key_pk - id ключа

Пример запроса:
import requests

requests.post("https://fornex.com/api/ssh_keys/34-177054/delete/", {  
  "key_pk": "74",
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/ssh_keys/34-177054/delete/" \
  --data "key_pk=74&apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "ok": true
}

Выделенные серверы

Лимиты трафика

URL: /api/ds/34-[order_id]/traffic_used.json
Метод запроса: GET
Параметры URL:

  • order_id - номер заказа

Пример запроса:
import requests

requests.get("https://fornex.com/api/ds/34-1234/traffic_used.json", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/ds/34-1234/traffic_used.json" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "limit": 14293651161088.0,
  "order": "34-1234 DS XeonNeon (example.net)",
  "range_end": "2015-11-21",
  "range_start": "2015-10-21",
  "used": 3508146044885.079,
  "used_rate": 0.24543386468220252
}

Трафик

URL: /api/ds/34-[order_id]/traffic.json
Метод запроса: GET
Параметры URL:

  • order_id - номер заказа

Параметры запроса:

  • period - период для отображения статистики [`month`|`year`], по умолчанию - `month`
  • port - порядковый номер порта, по умолчанию - `0`

Пример запроса:
import requests

requests.get("https://fornex.com/api/ds/34-1234/traffic.json", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/ds/34-1234/traffic.json" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "data": [
    [
      "2015-11-11",
      {
        "input": 41348840999.42331,
        "output": 969929788001.3163
      }
    ],
    [
      "2015-11-12",
      {
        "input": 44384423647.10196,
        "output": 1019910108491.1565
      }
    ]
  ],
  "order": "34-1234 DS HyperXeon (example.net)",
  "period": "month"
}
Дополнительно:

В ответе: `input`, `output` - трафик в байтах.

Тикеты

Настроить вебхук

На указанный URL будет отправлен POST-запрос

ContentType: 'application/json'
{text: 'К тикету добавлен новый комментарий...'}

По умолчанию работает со Slack, но Вы можете указать собственный вебхук и обработать уведомления самостоятельно.

URL: /api/tickets/webhook_set/
Метод запроса: POST
Параметры запроса:

  • url - URL на который будет отправлен запрос, для отключения - укажите пустую строку

Пример запроса:
import requests

requests.post("https://fornex.com/api/tickets/webhook_set/", {  
  "url": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX",
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/tickets/webhook_set/" \
  --data "url=https%3A%2F%2Fhooks.slack.com%2Fservices%2FT00000000%2FB00000000%2FXXXXXXXXXXXXXXXXXXXXXXXX&apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "ok": true
}

Статус вебхука

URL: /api/tickets/webhook_info/
Метод запроса: GET
Пример запроса:
import requests

requests.get("https://fornex.com/api/tickets/webhook_info/", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/tickets/webhook_info/" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "last_error_date": null,
  "last_error_message": null,
  "url": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX"
}

VPN

Скачать конфиг

URL: /api/vpn/[order]/config-[proto].ovpn
Метод запроса: GET
Параметры URL:

  • order - номер заказа
  • proto - протокол [`tcp`|`udp`]

Пример запроса:
import requests

requests.get("https://fornex.com/api/vpn/301-12312/config-udp.ovpn", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/vpn/301-12312/config-udp.ovpn" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
 client
 dev tun
 <connection>
    remote 209.222.104.210 443 udp
 </connection>
 ...

DNS

Добавить домен

Защищенный метод

Для использования этого метода обратитесь в техподдержку и запросите права на редактирование DNS.

URL: /api/dns/v0.1/add_domain/
Метод запроса: POST
Параметры запроса:

  • name - Доменное имя
  • ip - IP адрес

Пример запроса:
import requests

requests.post("https://fornex.com/api/dns/v0.1/add_domain/", {  
  "name": "example.com",
  "ip": "127.0.0.1",
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/dns/v0.1/add_domain/" \
  --data "name=example.com&ip=127.0.0.1&apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "ok": true,
  "name": "example.com"
}

Добавить запись

URL: /api/dns/v0.1/[name]/entry_set/add/
Метод запроса: POST
Параметры URL:

  • name - домен

Параметры запроса:

  • host - Хостнейм записи: `@, *, subdomain`
  • type - Тип записи: [`A`|`AAAA`|`TXT`|`SPF`|`CNAME`|`NS`|`MX`|`SRV`|`CAA`]
  • value - Значение записи, в соответствии с типом, например IP для A-записей
  • ttl - Время жизни (не обязательное, по умолчанию: 3600 сек.): [`120`(2 мин.) |`300`(5 мин.) |`600`(10 мин.) |`900`(15 мин.) |`1800`(30 мин.) |`3600`(1 час) |`7200`(2 часа) |`18000`(5 часов) |`43200`(12 часов) |`86400`(1 день) ]
  • prio - Приоритет, используется только для SRV и MX

Пример запроса:
import requests

requests.post("https://fornex.com/api/dns/v0.1/example.com/entry_set/add/", {  
  "host": "example",
  "type": "A",
  "value": "1.2.3.4",
  "ttl": "600",
  "prio": "5",
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/dns/v0.1/example.com/entry_set/add/" \
  --data "host=example&type=A&value=1.2.3.4&ttl=600&prio=5&apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "ok": true,
  "pk": 123
}

Записи домена

URL: /api/dns/v0.1/[name]/entry_set.json
Метод запроса: GET
Параметры URL:

  • name - домен

Параметры запроса:

  • q - фильтр записей

Пример запроса:
import requests

requests.get("https://fornex.com/api/dns/v0.1/example.com/entry_set.json", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/dns/v0.1/example.com/entry_set.json" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "entry_set": [
    {
      "id": 12344,
      "host": "",
      "prio": null,
      "type": "A",
      "ttl": 600,
      "value": "127.0.0.1"
    },
    {
      "id": 12345,
      "host": "",
      "type": "MX",
      "prio": 1,
      "ttl": null,
      "value": "aspmx.l.google.com"
    }
  ]
}

Обновить запись

URL: /api/dns/v0.1/[name]/entry_set/[pk]/
Метод запроса: POST
Параметры URL:

  • name - домен
  • pk - ID записи

Параметры запроса:

  • host - Хостнейм записи: `@, *, subdomain`
  • type - Тип записи: [`A`|`AAAA`|`TXT`|`SPF`|`CNAME`|`NS`|`MX`|`SRV`|`CAA`]
  • value - Значение записи, в соответствии с типом, например IP для A-записей
  • ttl - Время жизни (не обязательное, по умолчанию: 3600 сек.): [`120`(2 мин.) |`300`(5 мин.) |`600`(10 мин.) |`900`(15 мин.) |`1800`(30 мин.) |`3600`(1 час) |`7200`(2 часа) |`18000`(5 часов) |`43200`(12 часов) |`86400`(1 день) ]
  • prio - Приоритет, используется только для SRV и MX

Пример запроса:
import requests

requests.post("https://fornex.com/api/dns/v0.1/example.com/entry_set/366182/", {  
  "host": "example",
  "type": "A",
  "value": "1.2.3.4",
  "ttl": "600",
  "prio": "5",
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/dns/v0.1/example.com/entry_set/366182/" \
  --data "host=example&type=A&value=1.2.3.4&ttl=600&prio=5&apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "ok": true
}

Список доменов

URL: /api/dns/v0.1/domain_list.json
Метод запроса: GET
Параметры запроса:

  • q - поиск по названию или ip
  • tag - фильтрация по тегу

Пример запроса:
import requests

requests.get("https://fornex.com/api/dns/v0.1/domain_list.json", {  
  "q": "10.10.10.18",
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/dns/v0.1/domain_list.json" --get\
  --data "q=10.10.10.18&apikey=PERSONAL_API_KEY"
Пример ответа:
[
  {
    "name": "test.com",
    "created": "2013-04-16T19:07:10",
    "updated": "2017-02-05T21:41:25",
    "entry_set": [
      {
        "host": "",
        "id": 366182,
        "type": "A",
        "ttl": null,
        "value": "10.10.10.18"
      }
    ],
    "tags": []
  }
]

Удалить домен

Защищенный метод

Для использования этого метода обратитесь в техподдержку и запросите права на редактирование DNS.

URL: /api/dns/v0.1/[name]/delete_domain/
Метод запроса: POST
Параметры URL:

  • name - домен

Пример запроса:
import requests

requests.post("https://fornex.com/api/dns/v0.1/example.com/delete_domain/", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/dns/v0.1/example.com/delete_domain/" \
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "ok": true
}

Удалить запись

URL: /api/dns/v0.1/[name]/entry_set/[pk]/delete/
Метод запроса: POST
Параметры URL:

  • name - домен
  • pk - ID записи

Пример запроса:
import requests

requests.post("https://fornex.com/api/dns/v0.1/example.com/entry_set/366182/delete/", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/dns/v0.1/example.com/entry_set/366182/delete/" \
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
{
  "ok": true
}

Файл зоны

URL: /api/dns/v0.1/[name]/zone_file/
Метод запроса: GET
Параметры URL:

  • name - домен

Пример запроса:
import requests

requests.get("https://fornex.com/api/dns/v0.1/example.com/zone_file/", {  
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/dns/v0.1/example.com/zone_file/" --get\
  --data "apikey=PERSONAL_API_KEY"
Пример ответа:
$TTL 21600
@	IN	SOA	ns1.fornex.com. hostmaster.fornex.com. (
...

Домены

Изменить NS

URL: /api/change_ns/[order_id]/
Метод запроса: POST
Параметры URL:

  • order_id - номер заказа

Параметры запроса:

  • nss - список NS, разделенных запятой

Пример запроса:
import requests

requests.post("https://fornex.com/api/change_ns/375-13/", {  
  "nss": "ns1.company.com,ns2.company.com",
  "apikey": "PERSONAL_API_KEY"
})

$ curl "https://fornex.com/api/change_ns/375-13/" \
  --data "nss=ns1.company.com%2Cns2.company.com&apikey=PERSONAL_API_KEY"
Пример ответа:
[
  {
    "ok": true
  }
]