Введение

API работает с JSON по HTTPS. Каждый ответ — это объект с ключом data, а в списках есть еще и meta. Цены указаны за месяц, без НДС, в USD и EUR; метки времени — в UTC в формате ISO 8601.

Публичные эндпоинты описаны в спецификации OpenAPI 3.1, готовой для генераторов кода и ИИ-агентов; краткое описание DediJet простым языком для ИИ-ассистентов доступно в файле llms.txt.

Публичные эндпоинты открыты для всех и отдают Access-Control-Allow-Origin: *, поэтому их можно вызывать из браузера, скрипта или системы мониторинга — например, чтобы получить оповещение, когда распроданный сервер снова появится в наличии.

Запрос

curl -s https://dedijet.com/api/v1/plans/ryzen-9-9950x

Аутентификация

Эндпоинтам, которые работают с вашим аккаунтом, нужен API-токен, передаваемый как bearer-токен. Создавайте и отзывайте токены в личном кабинете, в разделе API-токены: каждый токен показывается только один раз, поэтому сохраните его в менеджере секретов. Пока токены дают доступ только на чтение. Храните их в тайне: любой, у кого есть токен, может читать данные вашего аккаунта.

Запрос

curl -s https://dedijet.com/api/v1/account \
  -H "Authorization: Bearer $DEDIJET_TOKEN"

Действия с серверами. Управление питанием, переустановка ОС и загрузка в режим восстановления появятся в API вместе с онлайн-оформлением заказа. До тех пор серверы доступны через API только для чтения.

Ошибки

Ошибки возвращаются со стандартными кодами состояния HTTP и телом единого формата:

Ответ с ошибкой

{
    "error": {
        "code": "not_found",
        "message": "No plan with this id. List plans with GET /api/v1/plans.",
        "docs": "https://dedijet.com/docs/api#errors"
    }
}

Статус	Код	Значение
`400`	`invalid_parameter`	Параметр запроса содержит неизвестное значение.
`401`	`unauthorized`, `invalid_token`	Токен отсутствует, недействителен или отозван.
`404`	`not_found`	Неизвестный эндпоинт или ID ресурса.
`405`	`method_not_allowed`	Эндпоинт доступен только для чтения: используйте `GET`.
`429`	`rate_limited`	Слишком много запросов; повторите попытку через время, указанное в `Retry-After`.
`503`	`unavailable`	Данные аккаунта временно недоступны; повторите попытку через время, указанное в `Retry-After`.

Лимиты запросов и кэширование

Публичные ответы кэшируются на 60 секунд (статус сети — на 30), поэтому более частый опрос не даст более свежих данных. Пожалуйста, отправляйте менее 60 публичных запросов в минуту с одного IP. Аутентифицированные запросы ограничены 120 запросами в минуту на токен, и каждый аутентифицированный ответ содержит заголовки RateLimit-Limit, RateLimit-Remaining и RateLimit-Reset. Данные аккаунта никогда не кэшируются.

Список тарифов

Публичный

GET/api/v1/plans

Все конфигурации серверов с ценами и наличием в реальном времени. Для фильтрации используйте параметры запроса.

Параметр	Тип	Описание
`family`	string	entry, performance, enterprise, storage или gpu
`location`	string	ID локации, например fra
`in_stock`	boolean	1 — вернуть только серверы, которые можно выдать прямо сейчас

Запрос

curl -s "https://dedijet.com/api/v1/plans?family=performance&in_stock=1"

Ответ · актуальные данные, сокращенно

{
    "data": [
        {
            "id": "ryzen-9-9950x",
            "name": "AMD Ryzen 9 9950X",
            "family": "performance",
            "cpu": {
                "model": "AMD Ryzen 9 9950X",
                "cores": 16,
                "threads": 32,
                "base_ghz": 4.3,
                "boost_ghz": 5.7,
                "architecture": "Zen 5",
                "l3_cache_mb": 64
            },
            "memory": {
                "size_gb": 128,
                "type": "DDR5",
                "ecc": false
            },
            "storage": "2 × 2 TB NVMe",
            "gpu": null,
            "network": {
                "port": "1 Gbps",
                "bandwidth": "unmetered",
                "ipv4": 1,
                "ipv6": "/64",
                "ddos_protection": true
            },
            "price": {
                "monthly": {
                    "usd": 269.0,
                    "eur": 234.0
                },
                "setup_fee": 0.0,
                "currency_note": "Monthly, excluding VAT"
            },
            "availability": {
                "in_stock": true,
                "delivery": "instant",
                "locations": [
                    "fra",
                    "ams",
                    "lon",
                    "nyc",
                    "lax",
                    "sin"
                ]
            },
            "links": {
                "page": "https://dedijet.com/servers/ryzen-9-9950x",
                "order": "https://dedijet.com/order/ryzen-9-9950x"
            }
        }
    ],
    "meta": {
        "count": 1,
        "in_stock": 1,
        "generated_at": "2026-10-16T02:10:37Z"
    }
}

Получение тарифа

Публичный

GET/api/v1/plans/{id}

Одна конфигурация по ID. Для распроданных тарифов указывается ID ближайшей альтернативы из наличия.

Параметр	Тип	Описание
`id`	string	ID тарифа, например ryzen-9-9950x

Запрос

curl -s "https://dedijet.com/api/v1/plans/ryzen-9-9950x"

Ответ · актуальные данные, сокращенно

{
    "data": {
        "id": "ryzen-9-9950x",
        "name": "AMD Ryzen 9 9950X",
        "family": "performance",
        "cpu": {
            "model": "AMD Ryzen 9 9950X",
            "cores": 16,
            "threads": 32,
            "base_ghz": 4.3,
            "boost_ghz": 5.7,
            "architecture": "Zen 5",
            "l3_cache_mb": 64
        },
        "memory": {
            "size_gb": 128,
            "type": "DDR5",
            "ecc": false
        },
        "storage": "2 × 2 TB NVMe",
        "gpu": null,
        "network": {
            "port": "1 Gbps",
            "bandwidth": "unmetered",
            "ipv4": 1,
            "ipv6": "/64",
            "ddos_protection": true
        },
        "price": {
            "monthly": {
                "usd": 269.0,
                "eur": 234.0
            },
            "setup_fee": 0.0,
            "currency_note": "Monthly, excluding VAT"
        },
        "availability": {
            "in_stock": true,
            "delivery": "instant",
            "locations": [
                "fra",
                "ams",
                "lon",
                "nyc",
                "lax",
                "sin"
            ]
        },
        "links": {
            "page": "https://dedijet.com/servers/ryzen-9-9950x",
            "order": "https://dedijet.com/order/ryzen-9-9950x"
        }
    }
}

Список локаций

Публичный

GET/api/v1/locations

Локации дата-центров с координатами и количеством тарифов в наличии.

Запрос

curl -s "https://dedijet.com/api/v1/locations"

Ответ · актуальные данные, сокращенно

{
    "data": [
        {
            "id": "fra",
            "iata": "FRA",
            "city": "Frankfurt",
            "country": "Germany",
            "country_code": "DE",
            "region": "Europe",
            "coordinates": {
                "lat": 50.1,
                "lon": 8.7
            },
            "plans": 15,
            "plans_in_stock": 10,
            "links": {
                "page": "https://dedijet.com/locations/frankfurt"
            }
        }
    ],
    "meta": {
        "count": 8
    }
}

Список операционных систем

Публичный

GET/api/v1/os

Образы ОС для установки в один клик со сроками поддержки и временем в минутах от подтверждения оплаты до готовности сервера к работе.

Запрос

curl -s "https://dedijet.com/api/v1/os"

Ответ · актуальные данные, сокращенно

{
    "data": [
        {
            "id": "ubuntu-2404",
            "name": "Ubuntu 24.04 LTS",
            "family": "Ubuntu",
            "version": "24.04 LTS",
            "support": "Standard support until April 2029",
            "typical_install_minutes": 2,
            "license": null
        }
    ],
    "meta": {
        "count": 15,
        "custom_iso": true
    }
}

Статус сети

Публичный

GET/api/v1/status

Статус компонентов по локациям и количество текущих инцидентов или предстоящих окон плановых работ.

Запрос

curl -s "https://dedijet.com/api/v1/status"

Ответ · актуальные данные, сокращенно

{
    "data": {
        "overall": "operational",
        "since": "2026-10-14",
        "locations": {
            "fra": {
                "city": "Frankfurt",
                "components": {
                    "network": "operational",
                    "ddos": "operational",
                    "provisioning": "operational",
                    "ipmi": "operational"
                }
            }
        },
        "ongoing": 0,
        "scheduled": 0,
        "updated_at": "2026-10-16T02:10:37Z"
    }
}

Ваш аккаунт

Требуется токен

GET/api/v1/account

ID вашего аккаунта, адрес электронной почты и баланс, а также сведения о том, включена ли двухфакторная аутентификация.

Запрос

curl -s "https://dedijet.com/api/v1/account" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"

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

{
    "data": {
        "id": "DJ-4KQ8M2X",
        "email": "(your sign-in email)",
        "name": null,
        "balance": {
            "usd": 625.0
        },
        "two_factor": true,
        "created_at": "2026-10-14T09:00:00Z"
    }
}

Список пополнений

Требуется токен

GET/api/v1/topups

Ваши пополнения (сначала новые) со статусом, монетой, зачисленной суммой и бонусом. Пока пополнение ожидает оплаты, в ответ включаются платежные реквизиты.

Параметр	Тип	Описание
`status`	string	Необязательный фильтр: pending, confirming, paid, expired, failed или canceled
`limit`	integer	От 1 до 100, по умолчанию 25
`page`	integer	Номер страницы, начиная с 1

Запрос

curl -s "https://dedijet.com/api/v1/topups" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"

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

{
    "data": [
        {
            "id": "TU-7K2M9QX4D",
            "status": "paid",
            "amount": {
                "usd": 500.0
            },
            "bonus_percent": 25,
            "coin": "usdt-trc20",
            "ticker": "USDT",
            "network": "TRON (TRC-20)",
            "payment": null,
            "confirmations": 19,
            "confirmations_needed": 19,
            "tx_hash": "9f3c41d2a7b8e05c6d1f2a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f",
            "credited": {
                "usd": 500.0,
                "bonus_usd": 125.0
            },
            "created_at": "2026-10-14T09:12:00Z",
            "paid_at": "2026-10-14T09:13:10Z",
            "links": {
                "page": "https://dedijet.com/account/billing/topup/TU-7K2M9QX4D"
            }
        }
    ],
    "meta": {
        "count": 1,
        "total": 1,
        "page": 1,
        "pages": 1,
        "limit": 25
    }
}

Получение пополнения

Требуется токен

GET/api/v1/topups/{id}

Одно пополнение по ID — например, чтобы отслеживать его подтверждения из скрипта. В примере — пополнение, ожидающее оплаты.

Параметр	Тип	Описание
`id`	string	ID пополнения, например TU-9QX4D7K2M

Запрос

curl -s "https://dedijet.com/api/v1/topups/TU-9QX4D7K2M" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"

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

{
    "data": {
        "id": "TU-9QX4D7K2M",
        "status": "pending",
        "amount": {
            "usd": 1000.0
        },
        "bonus_percent": 50,
        "coin": "btc",
        "ticker": "BTC",
        "network": "Bitcoin",
        "payment": {
            "address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
            "amount": "0.01563912",
            "memo": null,
            "uri": "bitcoin:bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq?amount=0.01563912",
            "rate_locked_until": "2026-10-14T10:30:00Z"
        },
        "confirmations": null,
        "confirmations_needed": 1,
        "tx_hash": null,
        "credited": null,
        "created_at": "2026-10-14T10:00:00Z",
        "paid_at": null,
        "links": {
            "page": "https://dedijet.com/account/billing/topup/TU-9QX4D7K2M"
        }
    }
}

Список операций по балансу

Требуется токен

GET/api/v1/transactions

Все зачисления и списания по балансу (сначала новые) с остатком после каждой операции.

Параметр	Тип	Описание
`limit`	integer	От 1 до 100, по умолчанию 50
`page`	integer	Номер страницы, начиная с 1

Запрос

curl -s "https://dedijet.com/api/v1/transactions" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"

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

{
    "data": [
        {
            "id": 2,
            "type": "bonus",
            "amount": {
                "usd": 125.0
            },
            "balance_after": {
                "usd": 625.0
            },
            "description": "Top-up bonus +25% · TU-7K2M9QX4D",
            "topup": "TU-7K2M9QX4D",
            "created_at": "2026-10-14T09:13:10Z"
        },
        {
            "id": 1,
            "type": "topup",
            "amount": {
                "usd": 500.0
            },
            "balance_after": {
                "usd": 500.0
            },
            "description": "Top-up TU-7K2M9QX4D · USDT",
            "topup": "TU-7K2M9QX4D",
            "created_at": "2026-10-14T09:13:10Z"
        }
    ],
    "meta": {
        "count": 2,
        "total": 2,
        "page": 1,
        "pages": 1,
        "limit": 50,
        "balance": {
            "usd": 625.0
        }
    }
}

Список сохраненных конфигураций

Требуется токен

GET/api/v1/configurations

Конфигурации серверов, сохраненные в конфигураторе, с ежемесячной ценой и ссылкой, которая снова открывает их в готовом к заказу виде.

Запрос

curl -s "https://dedijet.com/api/v1/configurations" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"

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

{
    "data": [
        {
            "id": "cfg_41",
            "plan": "ryzen-9-9950x",
            "location": "fra",
            "os": "debian-13",
            "hostname": "game1.example.com",
            "options": {
                "ipv4_extra": 2,
                "port_10g": false,
                "nvme": null,
                "hdd_extra": 0,
                "backup": null,
                "raid": "raid1"
            },
            "lines": [
                {
                    "label": "AMD Ryzen 9 9950X",
                    "usd": 269.0,
                    "eur": 234.0
                },
                {
                    "label": "2 additional IPv4",
                    "usd": 5.0,
                    "eur": 4.3
                }
            ],
            "price": {
                "monthly": {
                    "usd": 274.0,
                    "eur": 238.3
                },
                "currency_note": "Monthly, excluding VAT"
            },
            "in_stock": true,
            "created_at": "2026-10-14T09:20:00Z",
            "links": {
                "order": "https://dedijet.com/order/ryzen-9-9950x?loc=fra&os=debian-13&ipv4=2&hostname=game1.example.com"
            }
        }
    ],
    "meta": {
        "count": 1,
        "max": 20
    }
}

Список SSH-ключей

Требуется токен

GET/api/v1/ssh-keys

Открытые SSH-ключи, сохраненные в вашем аккаунте. Получить один ключ можно через /api/v1/ssh-keys/{id}.

Запрос

curl -s "https://dedijet.com/api/v1/ssh-keys" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"

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

{
    "data": [
        {
            "id": "key_7",
            "name": "laptop",
            "type": "ssh-ed25519",
            "fingerprint": "SHA256:2YhB0RmRk5hD8b2Fw3nH9L0w1u3c4QeXo6qZ7tP8sVk",
            "public_key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOMqqnkVzrm0SdG6UOoqKLsabgH5C9okWi0dh2l9GKJl you@laptop",
            "created_at": "2026-10-14T09:05:00Z"
        }
    ],
    "meta": {
        "count": 1
    }
}

Список ваших серверов

Требуется токен

GET/api/v1/servers

Выделенные серверы в вашем аккаунте со статусом, IP-адресом и датой продления. Получить один сервер можно через /api/v1/servers/{id}.

Запрос

curl -s "https://dedijet.com/api/v1/servers" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"

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

{
    "data": [
        {
            "id": "SV-8M2K4QX",
            "plan": "ryzen-9-9950x",
            "name": "AMD Ryzen 9 9950X",
            "location": "fra",
            "os": "debian-13",
            "hostname": "game1.example.com",
            "ipv4": "203.0.113.10",
            "status": "active",
            "price": {
                "monthly": {
                    "usd": 274.0
                }
            },
            "renews_at": "2026-11-14",
            "created_at": "2026-10-14T09:30:00Z"
        }
    ],
    "meta": {
        "count": 1,
        "active": 1
    }
}

Северная Америка

Европа

Азиатско-Тихоокеанский регион

Материалы

Разработчикам

Компания

DediJet API

Введение

Аутентификация

Ошибки

Лимиты запросов и кэширование

Список тарифов

Получение тарифа

Список локаций

Список операционных систем

Статус сети

Ваш аккаунт

Список пополнений

Получение пополнения

Список операций по балансу

Список сохраненных конфигураций

Список SSH-ключей

Список ваших серверов

Сброс пароля

Двухфакторная аутентификация

Сохраните ключ восстановления