Saltar al contenido principal
PATCH
/
v1
/
batches
/
{batch_id}
Actualizar metadatos del lote
curl --request PATCH \
  --url https://api.olostep.com/v1/batches/{batch_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metadata": {
    "status": "reviewed",
    "reviewer": "jane@example.com"
  }
}
'
{
  "id": "batch_abc123def456",
  "object": "batch",
  "status": "completed",
  "created": 1704067200,
  "total_urls": 10,
  "completed_urls": 10,
  "metadata": {
    "batch_name": "Q1 Product Sync",
    "status": "reviewed",
    "reviewer": "jane@example.com"
  }
}
Semántica de fusión: Las actualizaciones de metadatos siguen el enfoque de Stripe: se añaden nuevas claves, se actualizan las claves existentes y las claves establecidas en cadena vacía "" se eliminan.

Autorizaciones

​
Authorization
string
header
requerido

Encabezado de autenticación Bearer del formato Bearer , donde es tu token de autenticación.

Parámetros de ruta

​
batch_id
string
requerido

El ID del lote a actualizar.

Cuerpo

application/json
​
metadata
object
requerido

Conjunto de pares clave-valor para almacenar información adicional sobre un objeto. Sigue el enfoque de Stripe con reglas de validación: máximo 50 claves, clave máximo 40 caracteres (sin corchetes), valor máximo 500 caracteres, todos los valores almacenados como cadenas.

Ejemplo:
{
  "order_id": "12345",
  "customer_name": "John Doe",
  "priority": "high",
  "processed": "true"
}

Respuesta

Metadatos del lote actualizados con éxito.

​
id
string

ID del Lote

​
object
string

El tipo de objeto. "batch" para este endpoint.

​
status
string

in_progress o completed

​
created
number

Época creada

​
total_urls
number

Conteo de URLs en el lote

​
completed_urls
number

Conteo de URLs completadas

​
metadata
object

Conjunto de pares clave-valor para almacenar información adicional sobre un objeto. Sigue el enfoque de Stripe con reglas de validación: máximo 50 claves, clave máximo 40 caracteres (sin corchetes), valor máximo 500 caracteres, todos los valores almacenados como cadenas.

Ejemplo:
{
  "order_id": "12345",
  "customer_name": "John Doe",
  "priority": "high",
  "processed": "true"
}