BRIFLY
Войти

Список кнопок под блоком текста сообщения

Какие кнопки стоят под этой частью сообщения. Нужен, прежде чем менять действия, которые видит человек.

Какие кнопки стоят под этой частью сообщения. Нужен, прежде чем менять действия, которые видит человек.

Scope

content_factory:read

Заголовки

  • Content-Type: application/json
  • X-Api-Key — ключ проекта

Список кнопок под блоком текста сообщения

POST /v1/message-text-item-buttons/list. Scope content_factory:read.

Учебный пример магазина «Северная полка». Это не запись из вашей базы. Здесь кнопка: запрос и ответ на одном вызове.

Запрос

{
  "data": {
    "projectId": "11111111-1111-4111-8111-111111111111",
    "page": 1,
    "pageSize": 20
  }
}

Ответ (успех, 200)

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "46464646-4646-4464-8464-464646464646",
        "itemId": "45454545-4545-4454-8454-454545454545",
        "label": "Смотреть товар",
        "actionType": "url",
        "actionValue": "https://shop.example/kruzhka",
        "sortOrder": 1,
        "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-text-item-buttons/list" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: {{api_key}}" \
  -d '{"data": {"projectId": "11111111-1111-4111-8111-111111111111", "page": 1, "pageSize": 20}}'

Ошибки

  • 401 INVALID_API_KEY — нет ключа или ключ отозван.
  • 403 FORBIDDEN_SCOPE — у ключа нет content_factory:read.
  • 403 PROJECT_MISMATCH — в теле другой проект.
  • 429 RATE_LIMIT_EXCEEDED — заголовок Retry-After.
  • 400 VALIDATION_ERROR — не хватает поля в data.

Ограничения

  • Проект и пользователь берутся из ключа. Чужой data.projectId отвечает 403 PROJECT_MISMATCH.

См. также

Оцените статью — нам важна ваша обратная связь.

0 (0 оценок)