Диагностика ошибок

Если у вас возникла ошибка при отправке запросов в API и вам нужна помощь, обратитесь в техническую поддержку.

Чтобы помочь технической поддержке решить вашу проблему, вы можете использовать следующие заголовки при отправке HTTP-запросов:

  • X-Client-Request-ID — уникальный идентификатор запроса. Рекомендуем использовать UUID. Сообщите этот идентификатор технической поддержке, чтобы мы смогли найти конкретрный запрос в системе и помочь вам.

    Вы можете сгенерировать UUID онлайн или воспользоваться библиотекой для используемого языка программирования.

  • X-Data-Logging-Enabled — флаг, разрешающий сохранять данные, переданные пользователем в запросе.

    По умолчанию мы не сохраняем переданные вами аудио или текст. Если вы передадите значение true в этом заголовке, то ваши данные сохранятся. Вместе с идентификатором запроса это поможет технической поддержке решить вашу проблему.

Примеры

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

Пример использования заголовков с помощью cURL:

$ curl -X POST \
    -H "X-Client-Request-ID: fa18fa9b-176d-4ae0-92b8-bd7897f7c00c" \
    -H "X-Data-Logging-Enabled: true" \
    -H "Authorization: Bearer ${IAM_TOKEN}" \
    --data-binary "@speech.ogg" \
    "https://stt.api.cloud.yandex.net/speech/v1/stt:recognize?folderId=${FOLDER_ID}"