BRIFLY
Войти

Открыть прежнюю версию сценария разговора

Читает одну из прошлых публикаций, не подставляя её вместо текущей. Нужна, чтобы сверить, что изменилось.

Читает одну из прошлых публикаций, не подставляя её вместо текущей. Нужна, чтобы сверить, что изменилось.

Scope

scenarios:read

Заголовки

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

Открыть прежнюю версию сценария разговора

POST /v1/scenarios/get-version. Scope scenarios:read.

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

Запрос

{
  "data": {
    "projectId": "11111111-1111-4111-8111-111111111111",
    "id": "9b9b9b9b-9b9b-49b9-89b9-9b9b9b9b9b9b",
    "version": 2
  }
}

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

{
  "success": true,
  "data": {
    "scenarioId": "9b9b9b9b-9b9b-49b9-89b9-9b9b9b9b9b9b",
    "version": 2,
    "name": "Вопрос про кружку"
  }
}

Пример cURL

curl -X POST "https://api-external.brifly.online/v1/scenarios/get-version" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: {{api_key}}" \
  -d '{"data": {"projectId": "11111111-1111-4111-8111-111111111111", "id": "9b9b9b9b-9b9b-49b9-89b9-9b9b9b9b9b9b", "version": 2}}'

Ошибки

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

Ограничения

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

См. также

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

0 (0 оценок)