Bug report API

Endpoint: POST https://pm.buga.agency/bug-report

Призначення: Створення задачі на звіт про помилку (bug report) в ClickUp через API.

Авторизація

У заголовках запиту потрібно передати:

x-api-secret: <ваш секретний ключ>

Формат тіла запиту (multipart/form-data)

Поле	Тип	Обов’язкове	Опис
`currentURL`	`string`	✅	URL сторінки, де виникла помилка
`reporterName`	`string`	✅	Ім’я або ім’я користувача, який повідомляє
`comment`	`string`	❌	Додатковий опис помилки
`priority`	`number (1–4)`	❌	Пріоритет (1: Urgent, 2: High, 3: Normal (за замовчуванням), 4: Low)
`files`	`file[]`	❌	Вкладені файли (наприклад, скріни)
`listName`	`string`	❌	Назва списку задач у ClickUp (за замовчуванням: `Roller`)

Приклад запиту (з використанням cURL)

curl -X POST http://pm.buga.agency/bug-report \
  -H "x-api-secret: your-secret-key" \
  -F "currentURL=https://example.com/page" \
  -F "reporterName=John Doe" \
  -F "comment=Кнопка не працює" \
  -F "priority=2" \
  -F "[email protected]"

✅ Успішна відповідь

{
  "message": "Bug report created successfully",
  "taskId": "abcd1234",
  "taskUrl": "https://app.clickup.com/t/abcd1234",
  "backlogTaskId": "abcd1234",
  "backlogTaskUrl": "https://app.clickup.com/t/abcd1234"
}

❌ Можливі помилки

Код	Причина
`400`	Відсутні обов’язкові поля (`currentURL`, `reporterName`) або некоректне значення `priority`
`403`	Невірний або відсутній `x-api-secret`
`500`	Помилка генерації задачі або інша внутрішня помилка

Приклад відповіді з помилкою

{
  "error":"Missing required fields: currentURL or reporterName"
}

Примітки

Якщо listName не вказано або не знайдено, задачі створюються у списку Roller.
Якщо вказані файли, вони прикріплюються до задачі в ClickUp.
Поле priority автоматично встановлюється в 3 (Normal), якщо не задане.