API / Довідник методів / Підтримка
Підтримка
Звернення й відповіді в них.
Адреса:
https://sourhost.net/api/v1·Авторизація: Authorization: Bearer sh_live_…GET
/support/ticketsМої звернення
Право:
support:readПриклад запиту
curl "https://sourhost.net/api/v1/support/tickets" \
-H "Authorization: Bearer $SOURHOST_TOKEN"Відповідь
204 Порожня відповідь
GET
/support/tickets/:idЗвернення з листуванням
Право:
support:readПараметри
idобовʼязковий | path · string | Номер проєкту (з GET /projects) або тікета |
Приклад запиту
curl "https://sourhost.net/api/v1/support/tickets/12" \
-H "Authorization: Bearer $SOURHOST_TOKEN"Відповідь
204 Порожня відповідь
POST
/support/ticketsСтворити звернення
Поля форми, не JSON.
Право:
support:writeПараметри
subjectобовʼязковий | body · string | Тема |
messageобовʼязковий | body · string | Текст |
department | body · string | tech, billing, general або transfer |
serviceId | body · string | Послуга, про яку питання |
Приклад запиту
curl -X POST "https://sourhost.net/api/v1/support/tickets" \
-H "Authorization: Bearer $SOURHOST_TOKEN" \
--data-urlencode "subject=Сервер не стартует" \
--data-urlencode "message=После обновления сервер сразу падает." \
--data-urlencode "department=tech" \
--data-urlencode "serviceId=34"Відповідь
201 Успішна відповідь
POST
/support/tickets/:id/messagesВідповісти у зверненні
Право:
support:writeПараметри
idобовʼязковий | path · string | Номер проєкту (з GET /projects) або тікета |
Приклад запиту
curl -X POST "https://sourhost.net/api/v1/support/tickets/12/messages" \
-H "Authorization: Bearer $SOURHOST_TOKEN" \
--data-urlencode "text=Спасибо, заработало!"Відповідь
204 Порожня відповідь
Загальні помилки
Будь-який метод може відповісти так. Докладніше про помилки
| 400 | bad_request | Невірне тіло чи параметри |
| 401 | token_invalid | Токен невірний, відкликаний або прострочений |
| 403 | token_scope_missing | У токена немає потрібного права |
| 403 | token_project_forbidden | Проєкт чи послуга поза обмеженнями токена |
| 404 | not_found | Немає такого проєкту, послуги чи об’єкта |
| 429 | token_rate_limited | Забагато запитів, див. Retry-After |
| 503 | upstream_unavailable | Панель або нода не відповіли — повторіть пізніше |