Диагностика ошибок в Yandex Translate

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

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

Заголовки запросовЗаголовки запросов

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

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

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

• x-data-logging-enabled — флаг, разрешающий сохранять данные, переданные пользователем в запросе.

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

ПримерыПримеры

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

Пример запроса с помощью cURL:

export IAM_TOKEN=<IAM-токен>

curl \
  --request POST \
  --header "x-client-request-id: fa18fa9b-176d-4ae0-92b8-bd78********" \
  --header "x-data-logging-enabled: true" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${IAM_TOKEN}" \
  --data '@<путь_до_файла_json>' \
  "https://translate.api.cloud.yandex.net/translate/v2/translate"

Где IAM_TOKEN — IAM-токен, необходимый для аутентификации.

Заголовки ответовЗаголовки ответов

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

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

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

Пример реализации доступа к заголовкам протокола gRPC приведен в документации библиотеки grpc-go.