API / Довідник методів / Підтримка

Підтримка

Звернення й відповіді в них.

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Текст
departmentbody · stringtech, billing, general або transfer
serviceIdbody · 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 Порожня відповідь

Загальні помилки

Будь-який метод може відповісти так. Докладніше про помилки

400bad_requestНевірне тіло чи параметри
401token_invalidТокен невірний, відкликаний або прострочений
403token_scope_missingУ токена немає потрібного права
403token_project_forbiddenПроєкт чи послуга поза обмеженнями токена
404not_foundНемає такого проєкту, послуги чи об’єкта
429token_rate_limitedЗабагато запитів, див. Retry-After
503upstream_unavailableПанель або нода не відповіли — повторіть пізніше