Naar hoofdinhoud gaan
PATCH
/
v1
/
batches
/
{batch_id}
Batchmetadata bijwerken
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"
  }
}
Merge-semantic: Metadata-updates volgen de aanpak van Stripe — nieuwe sleutels worden toegevoegd, bestaande sleutels worden bijgewerkt, en sleutels die zijn ingesteld op een lege string "" worden verwijderd.

Autorisaties

​
Authorization
string
header
vereist

Bearer authenticatie header in de vorm Bearer , waarbij jouw auth token is.

Padparameters

​
batch_id
string
vereist

De ID van de batch die je wilt bijwerken.

Body

application/json
​
metadata
object
vereist

Set van sleutel-waarde paren voor het opslaan van aanvullende informatie over een object. Volgt de aanpak van Stripe met validatieregels: maximaal 50 sleutels, sleutel maximaal 40 tekens (geen vierkante haken), waarde maximaal 500 tekens, alle waarden opgeslagen als strings.

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

Respons

Batchmetadata succesvol bijgewerkt.

​
id
string

Batch ID

​
object
string

Het soort object. "batch" voor dit eindpunt.

​
status
string

in_progress of completed

​
created
number

Gemaakt epoch

​
total_urls
number

Aantal URLs in de batch

​
completed_urls
number

Aantal voltooide URLs

​
metadata
object

Set van sleutel-waarde paren voor het opslaan van aanvullende informatie over een object. Volgt de aanpak van Stripe met validatieregels: maximaal 50 sleutels, sleutel maximaal 40 tekens (geen vierkante haken), waarde maximaal 500 tekens, alle waarden opgeslagen als strings.

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