Produkte · Dateien hinzufügen · product_id

Dateien werden nach dem Erstellen von upload_id als multipart/form-data übertragen und anschließend einem Produkt zugeordnet. Downloads erfordern einen Bearer-Token und die Berechtigung für category; die Antwort enthält Dateibytes, keine öffentliche Adresse und kein Passwort. Ausdrückliche Zugriffsregel für die gemeinsam verkaufte Datei. new_purchases / recent_and_new / selected / all_purchasers.

POST/api/v1/products/{product_id}/files

cURL-Anfrage

curl --disable --globoff --fail-with-body --silent --show-error \
  --proto '=https' --connect-timeout 5 --max-time 30 \
  --request POST \
  --url 'https://shop.onshopently.com/api/v1/products/example/files?category=digital' \
  --header 'Authorization: Bearer EXAMPLE_ACCESS_TOKEN' \
  --header 'Idempotency-Key: files-example-assign_file_api_v1_products__product_id__files_post' \
  --header 'Content-Type: application/json' \
  --data-raw '{"audience":{"mode":"new_purchases"},"expected_version":1,"upload_id":"00000000-0000-4000-8000-000000000001"}'

Antwort

{
  "data": {
    "deleted": false,
    "id": "00000000-0000-4000-8000-000000000001",
    "version": 2
  },
  "meta": {
    "request_id": "example"
  }
}

Erforderliche Berechtigungen

Authentifizierung: Zugriffstoken
Verfügbar ab: STANDARD
Erforderliche Berechtigungen

Zusätzliche Berechtigungen für bestimmte Felder

category=internal: Produktdateien verwalten · Interne Dateiencatalog.product_file:write_internal
category=customer_document: Produktdateien verwalten · Kundendokumentecatalog.product_file:write_customer_document
category=digital: Produktdateien verwalten · Digitale Produktecatalog.product_file:write_digital