Troubleshooting

Basics

If you see errors when you submit a job or performing any other actions it might be worth checking few simple elements to potentially help avoid having to raise a support ticket.

Its worth checking few specific things:

  1. The end point. Ensure that you are using the correct end point. This is specifically important for trial users. End points can be found in the overview section of this documentation portal in the API endpoints subsection.
  2. The language code. Ensure that the language code is correct. These can be checked against the language list in the language support subsection of the overview sections.
  3. Token expiration. This is especially relevant for trial users. Trial tokens are valid for 14 days, to check the status of your trial ticket please reach out to your account point of contact at Speechmatics or please raise a support ticket.

If you need to raise a support ticket, then please open a ticket by emailing support@speechmatics.com.

Please provide the Request-Id and X-Azure-Ref headers, and (if you have it) the Job ID. A response for a successful job should look like this:

HTTP/1.1 201 Created
Content-Length: 20
Content-Type: application/json
Request-Id: df6ec500191bf2c02ee42d519fbea34f
Strict-Transport-Security: max-age=15724800; includeSubDomains
X-Azure-Ref: 01mDmXAAAAABUtz6ZgS7QRI2F3f5B+19wTE9OMjFFREdFMDMxMgBhN2JjOWQ4MC02YjBiLTQ1NWEtYjE3MS01NGJkZmNiYWE0YTk=
Date: Thu, 23 May 2019 08:59:08 GMT

{"id":"z2jfp1jwu1"}

In this example, the Request-Id is df6ec500191bf2c02ee42d519fbea34f and the Job ID is z2jfp1jwu1.

An error will be reported as a 4XX or 5XX status code; instead of the job ID an error message will be returned. The Request-Id can be included in the ticket to support to help support engineers troubleshoot the problem. Here's an example:

HTTP/1.1 401 Unauthorized
Content-Length: 179
Content-Type: text/html
Request-Id: 00adae505fa8cb7c7f24c6bf52c60048
Strict-Transport-Security: max-age=15724800; includeSubDomains
X-Azure-Ref: 0LWLmXAAAAAB2mDIdAu7kSZ/kKszi7eH4TE9OMjFFREdFMDMwOQBhN2JjOWQ4MC02YjBiLTQ1NWEtYjE3MS01NGJkZmNiYWE0YTk=
Date: Thu, 23 May 2019 09:04:49 GMT

<html>
<head><title>401 Authorization Required</title></head>
<body>
<center><h1>401 Authorization Required</h1></center>
<hr><center>nginx/1.15.8</center>
</body>
</html>

Rate Limited Requests

A 429 error means that the request has been rate limited by our API. This situation could be avoided by adding 1 second delay between requests of the same type, e.g., adding 1 second delay between GET /v2/jobs/{job_id} requests.

results matching ""

    No results matching ""