Referencia de API

Solicitar cancelación de tarea de vídeo

POST/v1/videos/{task_id}/cancel

Cancelación según modelo/tarea; 501 indica no compatible. Solicitar no implica cancelado ni reembolsado.

Autenticación y permisos

Usa tu clave actual de GloopAPI. Los modelos, capacidades y permisos dependen de su catálogo y de la documentación del endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticación: BearerAuth

Solicitud

Parámetros de ruta

  • task_idstringObligatorio

    ID público de tarea creada con la misma clave.

Respuestas y errores

HTTP 200

Solicitud correcta.

application/json

Tipo
object
Campos obligatorios
idcancel_requested

HTTP 401

La clave falta, no es válida, caducó o fue revocada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 403

La clave actual no tiene permiso.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio

HTTP 404

Objeto o capacidad no disponible.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio

HTTP 409

Conflicto, no preparado o envío desconocido; consulta primero el original, sin reenviar a ciegas.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio

HTTP 429

Límite de solicitudes/cola.

application/json

Tipo
object
Campos obligatorios
error

HTTP 500

Fallo interno de autenticación o almacenamiento de datos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 501

El modelo de vídeo no admite cancelación (cancel_unsupported); no significa reembolso.

application/json

Tipo
object
Campos obligatorios
error

HTTP 502

Error en la respuesta del servicio.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio

HTTP 503

Servicio, almacenamiento, precios temporalmente no disponibles.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio