Troubleshooting in Yandex Translate

If something went wrong while sending API requests and you need help, contact technical support.

The support team will solve your issue faster if you use advanced HTTP request and response headers.

Request headersRequest headers

When sending HTTP requests, use the following headers:

• x-client-request-id is a unique request ID. We recommend using a UUID. Send this ID to the technical support team to help us find a specific request in the system and assist you.

  You can generate a UUID either online or through the library for the programming language you use.

• x-data-logging-enabled: Flag that allows saving the data provided by the user in the request.

  By default, the service does not save the data you send over the API. If you provide the true value in this header, your data will be saved. This, along with the request ID, will help the support team to solve your problem.

ExamplesExamples

For example, you can use these headers to let us know that your text was poorly translated and help us refine our translation model.

export IAM_TOKEN=<IAM_token>

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 '@<path_to_JSON_file>' \
  "https://translate.api.cloud.yandex.net/translate/v2/translate"

Response headersResponse headers

Each server response contains headers that provide even more information about request execution, e.g., x-server-trace-id, which is the unique request execution log ID.

To get the x-server-trace-id value, your application must log server response headers.

You can find an example of implementing access to gRPC headers in the grpc-go documentation.