Leer las pistas de una fuente

GET

/v1/uploads/{id}/tracks

curl --request GET \
  --url https://api.iomza.com/v1/uploads/example/tracks \
  --header 'Authorization: Bearer <token>'

• Producción

Duración, video y cada pista de audio y subtítulos, para elegirlas antes de crear un job. Solo se lee la cabecera del archivo: un segundo aproximadamente, sea cual sea su tamaño.

Autorizaciones

• apiKey

Parámetros

Parámetros de ruta

id

obligatorio

string

Respuestas

200

Lo que contiene la fuente.

Tipo de contenidoapplication/json

GET /v1/uploads/{id}/tracks y POST /v1/probe: lo que contiene una fuente, antes de crear un job.

object

object

obligatorio

string

Valor permitido: source_tracks

duration

obligatorio

number

bitrate

obligatorio

number | null

video

obligatorio

Uno o varios de:

object

object

codec

obligatorio

string

width

obligatorio

number

height

obligatorio

number

frame_rate

obligatorio

number

interlaced

obligatorio

boolean

hdr

obligatorio

string | null

Valores permitidos: pq hlg

unsupported

obligatorio

string | null

Valores permitidos: dolby_vision_no_compatible_layer

null

null

audio_tracks

obligatorio

Array<object>

Una pista de audio de una fuente.

object

index

obligatorio

number

language

obligatorio

Tal como viene etiquetado en el archivo (normalmente ISO 639-2: “spa”, “eng”); null si no tiene etiqueta.

string | null

title

obligatorio

string | null

codec

obligatorio

string

channels

obligatorio

number

default

obligatorio

boolean

atmos

obligatorio

boolean

bitrate

obligatorio

Bits por segundo; null si el archivo no lo indica.

number | null

subtitle_tracks

obligatorio

Array<object>

Una pista de subtítulos de una fuente.

object

index

obligatorio

number

language

obligatorio

string | null

title

obligatorio

string | null

codec

obligatorio

string

default

obligatorio

boolean

forced

obligatorio

boolean

convertible

obligatorio

Los subtítulos de texto se convierten a WebVTT; los de imagen (PGS, DVD), no.

boolean

Ejemplo

{
  "object": "source_tracks",
  "video": {
    "hdr": "pq",
    "unsupported": "dolby_vision_no_compatible_layer"
  }
}

400

Campos inválidos: details lista cada problema con su ruta.

Tipo de contenidoapplication/json

object

error

obligatorio

object

code

obligatorio

Estable: decide con él.

string

Valores permitidos: validation_error unauthorized quota_exceeded insufficient_balance forbidden module_not_in_plan organization_suspended not_found conflict too_many_requests internal_error service_unavailable

message

obligatorio

En inglés, para personas; puede cambiar.

string

details

obligatorio

Cada problema, como ruta: mensaje (errores de validación).

Array<string>

Ejemplo

{
  "error": {
    "code": "validation_error"
  }
}

401

La API key falta, no es válida o está revocada.

Tipo de contenidoapplication/json

object

error

obligatorio

object

code

obligatorio

Estable: decide con él.

string

Valores permitidos: validation_error unauthorized quota_exceeded insufficient_balance forbidden module_not_in_plan organization_suspended not_found conflict too_many_requests internal_error service_unavailable

message

obligatorio

En inglés, para personas; puede cambiar.

string

details

obligatorio

Cada problema, como ruta: mensaje (errores de validación).

Array<string>

Ejemplo

{
  "error": {
    "code": "validation_error"
  }
}

403

Credenciales válidas que no pueden hacer esto (forbidden), tu plan no incluye el módulo al que pertenece la ruta (module_not_in_plan), o tu organización está suspendida (organization_suspended).

Tipo de contenidoapplication/json

object

error

obligatorio

object

code

obligatorio

Estable: decide con él.

string

Valores permitidos: validation_error unauthorized quota_exceeded insufficient_balance forbidden module_not_in_plan organization_suspended not_found conflict too_many_requests internal_error service_unavailable

message

obligatorio

En inglés, para personas; puede cambiar.

string

details

obligatorio

Cada problema, como ruta: mensaje (errores de validación).

Array<string>

Ejemplo

{
  "error": {
    "code": "validation_error"
  }
}

404

No existe en tu organización.

Tipo de contenidoapplication/json

object

error

obligatorio

object

code

obligatorio

Estable: decide con él.

string

Valores permitidos: validation_error unauthorized quota_exceeded insufficient_balance forbidden module_not_in_plan organization_suspended not_found conflict too_many_requests internal_error service_unavailable

message

obligatorio

En inglés, para personas; puede cambiar.

string

details

obligatorio

Cada problema, como ruta: mensaje (errores de validación).

Array<string>

Ejemplo

{
  "error": {
    "code": "validation_error"
  }
}

429

Demasiadas peticiones: espera y reintenta. Lo responde la pasarela, así que el cuerpo puede ser distinto.

Tipo de contenidoapplication/json

object

error

obligatorio

object

code

obligatorio

Estable: decide con él.

string

Valores permitidos: validation_error unauthorized quota_exceeded insufficient_balance forbidden module_not_in_plan organization_suspended not_found conflict too_many_requests internal_error service_unavailable

message

obligatorio

En inglés, para personas; puede cambiar.

string

details

obligatorio

Cada problema, como ruta: mensaje (errores de validación).

Array<string>

Ejemplo

{
  "error": {
    "code": "validation_error"
  }
}

500

Nuestro: reintenta, y avísanos si persiste.

Tipo de contenidoapplication/json

object

error

obligatorio

object

code

obligatorio

Estable: decide con él.

string

Valores permitidos: validation_error unauthorized quota_exceeded insufficient_balance forbidden module_not_in_plan organization_suspended not_found conflict too_many_requests internal_error service_unavailable

message

obligatorio

En inglés, para personas; puede cambiar.

string

details

obligatorio

Cada problema, como ruta: mensaje (errores de validación).

Array<string>

Ejemplo

{
  "error": {
    "code": "validation_error"
  }
}

503

No disponible por un momento: reintenta en unos segundos.

Tipo de contenidoapplication/json

object

error

obligatorio

object

code

obligatorio

Estable: decide con él.

string

Valores permitidos: validation_error unauthorized quota_exceeded insufficient_balance forbidden module_not_in_plan organization_suspended not_found conflict too_many_requests internal_error service_unavailable

message

obligatorio

En inglés, para personas; puede cambiar.

string

details

obligatorio

Cada problema, como ruta: mensaje (errores de validación).

Array<string>

Ejemplo

{
  "error": {
    "code": "validation_error"
  }
}