Поддержка

Обращения и ответы в них.

Адрес:https://sourhost.net/api/v1·Авторизация: Authorization: Bearer sh_live_…

GET/support/tickets— Мои обращения GET/support/tickets/:id— Обращение с перепиской POST/support/tickets— Создать обращение POST/support/tickets/:id/messages— Ответить в обращении

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`	Панель или нода не ответили — повторите позже