Читает одну из прошлых публикаций, не подставляя её вместо текущей. Нужна, чтобы сверить, что изменилось.
Scope
scenarios:read
Заголовки
Content-Type: application/jsonX-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}}'Ошибки
401INVALID_API_KEY— нет ключа или ключ отозван.403FORBIDDEN_SCOPE— у ключа нетscenarios:read.403PROJECT_MISMATCH— в теле другой проект.429RATE_LIMIT_EXCEEDED— заголовокRetry-After.400VALIDATION_ERROR— не хватает поля вdata.
Ограничения
- Проект и пользователь берутся из ключа. Чужой
data.projectIdотвечает403PROJECT_MISMATCH.