Bug report API

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

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

Авторизація

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

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

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

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

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

curl -X POST http://pm.buga.agency/bug-report \
  -H{
  "x-api-secret: your-secret-key" \
  -FcurrentURL": "currentURL=https://example.app.b2bshades.com/page" \
  -F",
  "reporterName=John Doe" \
  -FreporterName": "comment=Кнопка не працює" \
  -FRoman",
  "priority=2"comment":"Testing \file -Fupload",
  "[email protected]"files": [
    "https://t4.ftcdn.net/jpg/01/43/42/83/360_F_143428338_gcxw3Jcd0tJpkvvb53pfEztwtU9sxsgT.jpg",
    "https://raw.githubusercontent.com/VeiaG/VeiaG/refs/heads/main/README.md"
  ]
}

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

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

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

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

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

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

Примітки

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