добрыйхостинг

База знаний › API

API: публичные методы без токена

Каталог конфигураций и цен, список ПО и база знаний — доступны без авторизации.

2 мин чтения · раздел «API»

Эти методы не требуют токена и подходят для сайтов-витрин, ботов и интеграций. Лимит — 240 запросов в минуту с одного IP.

Каталог — GET /public/catalog

{"ok": true, "plans": [{"id": "2:10", "preset_id": 10, "dc_id": 2, "tier": "Start", "name": "2 vCPU · 4 ГБ · 40 ГБ", "country": "Нидерланды", "flag": "nl", "city": "Амстердам", "cpu_name": "", "cpu": 2, "ram": 4, "disk": 40, "eth": "250 Мбит/с", "ipv6": true, "os": [{"id": 5, "name": "Ubuntu 24.04"}, {"id": 7, "name": "Debian 12"}], "prices": {"720": 1090, "2160": 3090, "4320": 6090, "8640": 11900}}], "periods": [{"id": 720, "name": "1 месяц", "months": 1, "discount": 0}, {"id": 2160, "name": "3 месяца", "months": 3, "discount": 5}], "support": "@dobryhostbot"}

prices — за весь период в рублях, ключ — период в часах. Скрытые конфигурации не отдаются. При недоступности поставщика — 503 catalog_unavailable.

Список ПО — GET /public/software

{"ok": true, "recipes": [{"id": "docker", "name": "Docker CE + Compose", "description": "Docker Engine, Compose и Buildx…", "group": "Разработка", "requires": [], "conflicts": [], "ram": 1}, {"id": "3x-ui", "name": "3x-ui", "group": "Сеть и панели", "requires": [], "conflicts": [], "ram": 1}]}

requires — зависимости, ставятся автоматически; conflicts — нельзя выбрать вместе; ram — минимум ГБ.

База знаний

  • GET /public/kb — разделы и статьи (articles[]: slug, title, summary, category, tags, views), popular[].
  • GET /public/kb/search?q=firewall&limit=5 — поиск по заголовку, тегам и тексту:
{"ok": true, "q": "firewall", "results": [{"id": 13, "slug": "firewall", "category": "manage", "category_title": "Управление сервером", "title": "Firewall: пресеты, порты, белый список", "summary": "Управление ufw из кабинета без риска закрыть себе SSH.", "score": 23}]}
  • GET /public/kb/{slug} — статья: article.body (Markdown), article.minutes, related[].
  • POST /public/kb/{slug}/helpful {"helpful": true} — оценка (по одной с адреса/аккаунта).

Ссылка на статью на сайте: https://dobry.host/help/<slug>.html.

Смотрите также