[Документация Yandex Cloud](../../index.md) > [speechkit](../index.md) > Решение проблем > Заголовки для диагностики ошибок

# Заголовки запросов для диагностики ошибок в Yandex SpeechKit


{% note info %}

В [регионе Казахстан](../../overview/concepts/region.md) доступна только версия API v3.

{% endnote %}


Если у вас возникла ошибка при отправке запросов в API и вам нужна помощь, воспользуйтесь [рекомендациями](response.md) или обратитесь в [техническую поддержку](../../support/overview.md).

Техническая поддержка сможет быстрее решить вашу проблему, если вы будете использовать дополнительные заголовки HTTP-запросов и ответов.

## Заголовки запросов {#request-headers}

При отправке HTTP-запросов используйте следующие заголовки:

* `x-client-request-id` — уникальный идентификатор запроса. Рекомендуем использовать [UUID](https://ru.wikipedia.org/wiki/UUID). Сообщите этот идентификатор технической поддержке, чтобы мы смогли найти конкретный запрос в системе и помочь вам.
  
  Вы можете сгенерировать UUID [онлайн](https://uuid.js.org) или воспользоваться библиотекой для используемого языка программирования.
* `x-data-logging-enabled` — флаг, разрешающий сохранять данные, переданные пользователем в запросе.

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

### Примеры {#examples}

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

{% list tabs group=programming_language %}

- cURL {#curl}

  ```bash
  export FOLDER_ID=<идентификатор_каталога>
  export IAM_TOKEN=<IAM-токен>

  curl \
    --verbose \
    --insecure \
    --header "x-client-request-id: fa18fa9b-176d-4ae0-92b8-bd78********" \
    --header "x-data-logging-enabled: true" \
    --header "authorization: Bearer ${IAM_TOKEN}" \
    --header "x-folder-id: ${FOLDER_ID}" \
    --data @request.json https://stt.api.ml.yandexcloud.kz:443/stt/v3/recognizeFileAsync
  ```

  Где:

  * `FOLDER_ID` — [идентификатор каталога](*идентификатор каталога), на который у вашего аккаунта есть роль `editor` или выше.
  * `IAM_TOKEN` — [IAM-токен](../../iam/operations/iam-token/create.md), необходимый для аутентификации.
  * `request.json` — файл с телом запроса на [распознавание](../stt/api/transcribation-api-v3.md).

  {% note tip %}

  Используйте флаг `-v` или `--verbose`, чтобы вывести в терминал полный лог выполнения команды.

  {% endnote %}

{% endlist %}

## Заголовки ответов {#response-headers}

Каждый ответ сервера содержит заголовки, которые позволят получить еще больше информации о ходе выполнения запроса:

* `x-request-id` — уникальный идентификатор ответа.
* `x-server-trace-id` — уникальный идентификатор логов выполнения запроса.

Чтобы получить значения `x-request-id` и `x-server-trace-id`, ваше приложение должно логировать заголовки ответов сервера.

Пример реализации доступа к заголовкам протокола gRPC приведен в [документации библиотеки `grpc-go`](https://github.com/grpc/grpc-go/blob/master/Documentation/grpc-metadata.md).

[*идентификатор каталога]: #### {#get-folder-id}
                           
                           [Каталог](../../resource-manager/concepts/resources-hierarchy.md#folder) — пространство, в котором содержатся ресурсы Yandex Cloud. Для аутентификации в AI Studio необходим идентификатор каталога. Чтобы его получить, в [интерфейсе AI Studio](https://aistudio.yandex.ru/platform) наведите указатель на название каталога, расположенное в верхней части экрана, и нажмите ![image](../../_assets/ai-studio/folder-id.svg). Идентификатор будет скопирован в буфер обмена.
                           
                           ![image](../../_assets/ai-studio/ai-studio-get-folder-id.png)