المنتجات · إضافة ملفات · product_id
بعد إنشاء upload_id أرسل الملفات بصيغة multipart/form-data ثم اربطها بالمنتج. يتطلب التنزيل رمز Bearer وصلاحية category؛ يحتوي الرد على بايتات الملف دون عنوان عام أو كلمة مرور. قاعدة وصول صريحة إلى الملف المشترك. new_purchases / recent_and_new / selected / all_purchasers.
POST
/api/v1/products/{product_id}/filesطلب 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/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"}'
الاستجابة
{
"data": {
"deleted": false,
"id": "00000000-0000-4000-8000-000000000001",
"version": 2
},
"meta": {
"request_id": "example"
}
}
الصلاحيات المطلوبة
- المصادقة
- رمز الوصول
- متاح بدءًا من
- STANDARD
- الصلاحيات المطلوبة
صلاحيات إضافية لحقول محددة
category=internal: إدارة ملفات المنتج · ملفات داخليةcatalog.product_file:write_internalcategory=customer_document: إدارة ملفات المنتج · مستندات العميلcatalog.product_file:write_customer_documentcategory=digital: إدارة ملفات المنتج · منتجات رقميةcatalog.product_file:write_digital