Тексты, привязанные к конкретному товару. Нужен, когда смотрите карточку и хотите все сообщения по ней, а не весь архив завода.
Scope
content_factory:read
Заголовки
Content-Type: application/jsonX-Api-Key— ключ проекта
Список текстов сообщений одного товара
POST /v1/message-texts/list-by-product. Scope content_factory:read.
Учебный пример магазина «Северная полка». Это не запись из вашей базы. Здесь текст: запрос и ответ на одном вызове.
Запрос
{
"data": {
"projectId": "11111111-1111-4111-8111-111111111111",
"page": 1,
"pageSize": 20,
"productId": "55555555-5555-4555-8555-555555555555"
}
}Ответ (успех, 200)
{
"success": true,
"data": {
"items": [
{
"id": "44444444-4444-4444-8444-444444444444",
"title": "Тёплая кружка на холодное утро",
"status": "draft",
"channel": "site",
"languageCode": "ru",
"productId": "55555555-5555-4555-8555-555555555555",
"taskId": "33333333-3333-4333-8333-333333333333",
"archivedAt": null,
"projectId": "11111111-1111-4111-8111-111111111111",
"createdAt": "2026-10-16T09:00:00.000Z",
"updatedAt": "2026-10-16T09:12:00.000Z"
}
],
"total": 1,
"page": 1,
"pageSize": 20
}
}Пример cURL
curl -X POST "https://api-external.brifly.online/v1/message-texts/list-by-product" \
-H "Content-Type: application/json" \
-H "X-Api-Key: {{api_key}}" \
-d '{"data": {"projectId": "11111111-1111-4111-8111-111111111111", "page": 1, "pageSize": 20, "productId": "55555555-5555-4555-8555-555555555555"}}'Ошибки
401INVALID_API_KEY— нет ключа или ключ отозван.403FORBIDDEN_SCOPE— у ключа нетcontent_factory:read.403PROJECT_MISMATCH— в теле другой проект.429RATE_LIMIT_EXCEEDED— заголовокRetry-After.400VALIDATION_ERROR— не хватает поля вdata.
Ограничения
- Проект и пользователь берутся из ключа. Чужой
data.projectIdотвечает403PROJECT_MISMATCH.