Примеры запросов
Готовые шаблоны HTTP-запросов на cURL, JavaScript и Python
Ниже — готовые шаблоны HTTP-запросов к Inspecto API. В примерах:
YOUR_TOKEN_HERE— токен сервисного аккаунта (см. Аутентификация);org.inspecto.in— поддомен вашей организации (замените на свой).
Поддомен организации
Запросы к данным организации (проекты, инспекции, задачи, несоответствия, справочники) идут на поддомен организации, а не на корневой inspecto.in. Полный список эндпоинтов — в Swagger UI.
Получить список проектов
GET /api/projects — список проектов, доступных сервисному аккаунту. Параметры count и offset обязательны для пагинации; q и sort — опциональные.
curl -X GET "https://org.inspecto.in/api/projects?count=20&offset=0" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Content-Type: application/json"Создать задачу
POST /api/tasks — создаёт задачу в указанном проекте.
Поля тела запроса
| Поле | Тип | Назначение |
|---|---|---|
project_id | number | ID проекта, в котором создаётся задача |
title | string (3–100) | Название задачи |
description | object | Описание в блочном формате { version, blocks: [...] } |
status_id | number | ID статуса задачи (получить через GET /api/tasks/statuses) |
priority | number | Числовой приоритет (см. ниже) |
due_date | string (ISO 8601) | Срок выполнения |
assignees | array | Опционально: [{ type: 'user' | 'group', id }] |
Числовые приоритеты
0 — без приоритета · 1 — очень низкий · 2 — низкий · 5 — средний · 6 — высокий · 7 — очень высокий · 9 — критический · 10 — блокирует работу.
Пример запроса
curl -X POST "https://org.inspecto.in/api/tasks" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Content-Type: application/json" \
-d '{
"project_id": 1,
"title": "Проверить оборудование",
"description": { "version": 1, "blocks": [] },
"status_id": 1,
"priority": 6,
"due_date": "2026-06-01T12:00:00Z",
"assignees": [{ "type": "user", "id": 42 }]
}'Обработка ошибок
API использует стандартные HTTP-коды:
| Код | Значение |
|---|---|
200 / 201 | Успех |
400 | Ошибка валидации — тело запроса не прошло проверку |
401 | Токен отсутствует или недействителен |
403 | У сервисного аккаунта нет прав на эту операцию — проверьте роли |
404 | Объект не найден |
429 | Превышен лимит запросов |
451 | Действие недоступно по правовым ограничениям (например, тарифу) |
5xx | Внутренняя ошибка — повторите запрос с экспоненциальной задержкой |
Повторные запросы
Для запросов изменения данных (POST, PUT, DELETE) реализуйте идемпотентность на своей стороне — не повторяйте автоматически без явной защиты от дублей, чтобы не создать одну и ту же задачу несколько раз.