Leer las pistas de un video en una URL

POST

/v1/probe

curl --request POST \
  --url https://api.iomza.com/v1/probe \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "url": "example" }'

• Producción

Como las pistas de una subida, para un video en una URL, sin copiarlo.

Autorizaciones

• apiKey

Cuerpo de la petición^obligatorio

Tipo de contenidoapplication/json

object

url

obligatorio

Una URL https pública o prefirmada del video.

string

<= 4096 caracteres

Ejemplo ^generated

{
  "url": "example"
}

Respuestas

200

Lo que contiene el video.

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"
  }
}

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"
  }
}