Massen-Medien-Batch erstellen - Scanova API Documentation

curl -X POST "https://api.scanova.io/media/bulk/" \
  -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
  -H "Content-Type: application/json" \
  -d '{ "count": 25 }'

{
  "id": 12,
  "operation_id": "BM-9F3K2LQP",
  "status": "new",
  "count": 25,
  "upload_count": 0,
  "created": "2026-09-08T09:00:00Z",
  "modified": "2026-09-08T09:00:00Z"
}

POST

/

media

/

bulk

/

curl -X POST "https://api.scanova.io/media/bulk/" \
  -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
  -H "Content-Type: application/json" \
  -d '{ "count": 25 }'

{
  "id": 12,
  "operation_id": "BM-9F3K2LQP",
  "status": "new",
  "count": 25,
  "upload_count": 0,
  "created": "2026-09-08T09:00:00Z",
  "modified": "2026-09-08T09:00:00Z"
}

Reserviert einen Batch für eine Reihe zusammengehöriger Datei-Uploads, auf dem Management-API-Host (api.scanova.io), authentifiziert mit Ihrem rohen Management-API-Schlüssel.

POST https://api.scanova.io/media/bulk/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a

integer

Die Anzahl der Dateien, die Sie in diesen Batch hochladen möchten — wird verwendet, um die BULK_MEDIA-Quota des Kontos vorab zu prüfen, bevor Sie mit dem Hochladen beginnen.

curl -X POST "https://api.scanova.io/media/bulk/" \
  -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
  -H "Content-Type: application/json" \
  -d '{ "count": 25 }'

{
  "id": 12,
  "operation_id": "BM-9F3K2LQP",
  "status": "new",
  "count": 25,
  "upload_count": 0,
  "created": "2026-09-08T09:00:00Z",
  "modified": "2026-09-08T09:00:00Z"
}

operation_id wird serverseitig generiert. Laden Sie nach dem Erstellen eines Batches jede Datei über Datei hochladen hoch, wobei bulk_media auf die id dieses Batches gesetzt wird. 403, wenn das Konto seine BULK_MEDIA-Upload-Quota für die angegebene count bereits ausgeschöpft hat:

403

{ "detail": "You have exhausted your limit of 100 Bulk Media uploads.", "limit": 100 }

Verwandte Themen

Massen-Medien-Batches auflisten — bestehende Batches ansehen.
Datei hochladen — in diesen Batch hochladen.
Übersicht über die Management API — das Authentifizierungsschema und die Quota-Regeln für diesen Endpunkt.

Autorisierungen

Authorization

string

header

erforderlich

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.

Antwort

Batch created.