Produits · Ajouter des fichiers · upload_id

Transmettez les fichiers en multipart/form-data après la création de upload_id, puis associez-les au produit. Le téléchargement exige un jeton Bearer et le droit correspondant à category ; la réponse contient les octets, sans adresse publique ni mot de passe. Règle d’accès explicite au fichier partagé vendu. new_purchases / recent_and_new / selected / all_purchasers.

POST/api/v1/product-file-uploads

Requête cURL

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/product-file-uploads?category=digital' \
  --header 'Authorization: Bearer EXAMPLE_ACCESS_TOKEN' \
  --header 'Idempotency-Key: files-example-create_upload_api_v1_product_file_uploads_post' \
  --header 'Content-Type: application/json' \
  --data-raw '{"filename":"manual.pdf","product_id":"example","sha256":"5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd","size_bytes":46}'

Réponse

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

Autorisations requises

Authentification: Jeton d’accès
Disponible à partir de: STANDARD
Autorisations requises

Autorisations supplémentaires pour certains champs

category=internal: Gérer les fichiers produit · Fichiers internescatalog.product_file:write_internal
category=customer_document: Gérer les fichiers produit · Documents clientcatalog.product_file:write_customer_document
category=digital: Gérer les fichiers produit · Produits numériquescatalog.product_file:write_digital