Прочитать текущее состояние асинхронной задачи

GET

/result/{task_id}

curl --request GET \
  --url https://stt.techcon-ml.ru/result/example \
  --header 'Authorization: Bearer <token>'

Канонический путь опроса результата после повторного подключения, повторной попытки или пропущенного уведомления. Ключ результата получает TTL 86400 секунд в момент постановки задачи в очередь, поэтому доступность после done или failed зависит от общей длительности задачи.

Authorizations

• bearerAuth

Parameters

Path Parameters

task_id

required

string

Идентификатор задачи, полученный при 202 Accepted.

Responses

200

Задача завершилась и её итоговое состояние доступно.

Media typeapplication/json

object

ok

required

boolean

data

required

object

task_id

required

string

status

required

string

result

object

transcription

required

Распознанный текст. Может быть пустой строкой, если полезной речи не найдено.

string

service

required

Имя публичного сервиса, сформировавшего результат.

string

processing_time_ms

integer

completed_at

string

error

string

failed_at

string

metadata

object

key

additional properties

any

webhook

object

configured

required

boolean

status

required

string

delivery_id

string

delivered_at

string

last_attempt_at

string

next_attempt_at

string

last_error

string

Example

{
  "data": {
    "result": {
      "transcription": "трещина на фасаде",
      "service": "stt"
    }
  }
}

202

Задача всё ещё стоит в очереди или выполняется.

Media typeapplication/json

object

ok

required

boolean

data

required

object

task_id

required

string

status

required

string

result

object

transcription

required

Распознанный текст. Может быть пустой строкой, если полезной речи не найдено.

string

service

required

Имя публичного сервиса, сформировавшего результат.

string

processing_time_ms

integer

completed_at

string

error

string

failed_at

string

metadata

object

key

additional properties

any

webhook

object

configured

required

boolean

status

required

string

delivery_id

string

delivered_at

string

last_attempt_at

string

next_attempt_at

string

last_error

string

Example

{
  "data": {
    "result": {
      "transcription": "трещина на фасаде",
      "service": "stt"
    }
  }
}

401

Bearer-токен отсутствует или неверен.

Media typeapplication/json

object

ok

required

boolean

error

required

object

code

required

string

message

required

string

Example

{
  "ok": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Bearer-токен отсутствует или неверен."
  }
}

404

Идентификатор задачи не найден или результат уже истёк.

429

Превышен лимит запросов на токен.

Media typeapplication/json

object

ok

required

boolean

error

required

object

code

required

string

message

required

string

Example

{
  "ok": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Превышен лимит запросов на токен."
  }
}

Headers

Retry-After

string

Example

60

Через сколько секунд безопасно повторить запрос.

503

Состояние STT-задачи сейчас нельзя прочитать: либо Redis недоступен, либо не настроен канонический набор Bearer-токенов.

Media typeapplication/json

object

ok

required

boolean

error

required

object

code

required

string

message

required

string

Example

{
  "ok": false,
  "error": {
    "code": "QUEUE_UNAVAILABLE",
    "message": "STT-задача не была поставлена в очередь: очередь сейчас недоступна."
  }
}