Список фоновых задач ИИ: генерация, разбор, долгие шаги, которые не кончаются в одном ответе. Смотрите его, чтобы понять, что ещё считается, а что уже можно забирать.
Scope
ai_jobs:read
Заголовки
Content-Type: application/jsonX-Api-Key— ключ проекта
Список задач ИИ, которые сейчас идут
POST /v1/ai-jobs/list. Scope ai_jobs:read.
Учебный пример магазина «Северная полка». Это не запись из вашей базы. Здесь задача ИИ: запрос и ответ на одном вызове.
Запрос
{
"data": {
"projectId": "11111111-1111-4111-8111-111111111111",
"status": "running",
"limit": 20
}
}Ответ (успех, 200)
{
"success": true,
"data": {
"items": [
{
"id": "66666666-6666-4666-8666-666666666666",
"projectId": "11111111-1111-4111-8111-111111111111",
"jobType": "content_factory_message",
"status": "running",
"progress": 40,
"currentStep": "Пишет текст поста",
"errorMessage": null,
"createdAt": "2026-10-16T09:00:00.000Z",
"completedAt": null
}
],
"total": 1
}
}Пример cURL
curl -X POST "https://api-external.brifly.online/v1/ai-jobs/list" \
-H "Content-Type: application/json" \
-H "X-Api-Key: {{api_key}}" \
-d '{"data": {"projectId": "11111111-1111-4111-8111-111111111111", "status": "running", "limit": 20}}'Ошибки
401INVALID_API_KEY— нет ключа или ключ отозван.403FORBIDDEN_SCOPE— у ключа нетai_jobs:read.403PROJECT_MISMATCH— в теле другой проект.429RATE_LIMIT_EXCEEDED— заголовокRetry-After.400VALIDATION_ERROR— не хватает поля вdata.
Ограничения
- Проект и пользователь берутся из ключа. Чужой
data.projectIdотвечает403PROJECT_MISMATCH.