POST Fulfillment Upload Delivery Image
Tải Lên Ảnh Giao Hàng Fulfillment Shop Scope yêu cầu: seller.fulfillment.basic API này được người bán sử dụng để tải lên ảnh bằng chứng giao hàng cho một kiện hàng, và để tạo URL của tệp tương ứng. URL được tạo ra sẽ dùng trong Update Package Delivery Status API
để xác nhận rằng kiện hàng đã được giao.
Yêu cầu sử dụng:
- Định dạng ảnh phải là JPEG, PNG, hoặc JPG.
- Kích thước ảnh không được vượt quá 5MB. Version 202309
POST/fulfillment/202309/images/upload
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được phép: multipart/form-data |
| x-tts-access-token Required | string | Giá trị access_token của người bán từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi API request đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các API request. Nhà phát triển có thể dùng giá trị này để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Sử dụng property này để truyền thông tin shop khi gọi API. Nếu không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về response không chính xác. Lấy bằng API Get Authorization Shop |
| category_asset_cipher | string | Định danh đối tác được sử dụng trong các API request. Lấy giá trị này bằng cách dùng Get Authorized Category Assets API. |
Body
| Properties | Type | Description |
|---|---|---|
| data Required | file | Dữ liệu tệp ảnh sẽ được tải lên TikTok Shop. Tệp ảnh là một chuỗi được tạo bằng mã hóa base64.Điều kiện tiên quyết：- Định dạng ảnh phải là JPG, JPEG, hoặc PNG.- Độ phân giải ảnh phải nằm trong khoảng 100 x 100px đến 20000 x 20000px.- Kích thước ảnh không được vượt quá 5MB. |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong API response. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong API response. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Request log |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 12019116 | Invalid image resolution. Please ensure your image is between 100 x 100 pixels and 20000 x 20000 pixels. | | 12038002 | Invalid upload file. Please ensure you are passing the correct file data. | | 12038004 | Invalid image file type. Please ensure your image is in JPG, JPEG, or PNG format. | | 12038005 | Invalid image file size. Please ensure your image file size does not exceed 5MB. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext