Completar una subida

POST

/v1/uploads/{id}/complete

curl --request POST \
  --url https://api.iomza.com/v1/uploads/example/complete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "parts": [ { "part_number": 1, "etag": "example" } ] }'

• Producción

Subidas simples: después del PUT. Multipart: con el ETag de cada parte. Una segunda llamada devuelve la subida sin cambios. Las subidas progresivas y las copias desde una URL se completan solas.

Autorizaciones

• apiKey

Parámetros

Parámetros de ruta

id

obligatorio

string

Cuerpo de la petición^obligatorio

Tipo de contenidoapplication/json

object

parts

Solo subidas multipart: cada parte con su ETag.

Array<object>

>= 1 elementos

object

part_number

obligatorio

integer

>= 1 <= 10000

etag

obligatorio

La cabecera ETag de la respuesta al PUT de la parte.

string

>= 1 caracteres

Ejemplo ^generated

{
  "parts": [
    {
      "part_number": 1,
      "etag": "example"
    }
  ]
}

Respuestas

200

La subida, completada.

Tipo de contenidoapplication/json

Un archivo fuente: subido, subiéndose, o copiado de una URL por un job. Se guarda 7 días.

object

id

obligatorio

string

object

obligatorio

string

Valor permitido: upload

status

obligatorio

completed cuando el archivo entero está guardado.

string

Valores permitidos: pending completed

file_name

obligatorio

string

size

obligatorio

number | null

mode

obligatorio

Cómo llega: single (un PUT), multipart (partes en paralelo, y luego complete), progressive (partes legibles a medida que llegan, sin complete) o url (copiada por el job al que se le dio la URL; se completa cuando termina la copia).

string

Valores permitidos: single multipart progressive url

source_url

obligatorio

De dónde vino una fuente importada.

string | null

created_at

obligatorio

string formato: date-time

completed_at

obligatorio

string | null formato: date-time

Ejemplo

{
  "object": "upload",
  "status": "pending",
  "mode": "single"
}

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