Chuyển tới nội dung chính

v2.product.get_item_violation_info

GET /api/v2/product/get_item_violation_info

get item violation info

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/product/get_item_violation_info

Tham số chung

TênKiểuMẫuMô tả
partner_idint1Partner ID được gán khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu.
timestamptimestamp1610000000Dùng để chỉ định thời gian của yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1Token truy cập API, dùng để xác định quyền của bạn đối với API. Có thể sử dụng nhiều lần và hết hạn sau 4 giờ.
shop_idint600000Mã định danh duy nhất của Shopee cho một cửa hàng. Tham số bắt buộc cho hầu hết các API.
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Tham số Request

TênKiểuBắt buộcMẫuMô tả
item_id_listint[]True[34001,34002]item_id list; limit [0,50]

Tham số Response

TênKiểuMẫuMô tả
errorstringLoại lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
messagestringChi tiết lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
warningstringIndicate waring details if hit waring. Empty if no waring happened.
request_idstringMã định danh của yêu cầu API dùng để theo dõi lỗi.
responseobject
item_listobject[]
item_idint3400133011Shopee's mã định danh duy nhất for an item.
item_namestringtestName of the item.
item_statusstringBANNEDEnumerated type that defines the current status of the item. Các giá trị áp dụng: NORMAL, BANNED, UNLIST, SELLER_DELETE, SHOPEE_DELETE, REVIEWING.
deboostbooleantrueIf deboost is true, means that the item's search ranking is lowered.
item_status_detailsobject[]
violation_typestringProhibited ListingViolation types defined by Shopee. Các giá trị áp dụng: Prohibited Listing Counterfeit and IP Infringement Spam Inappropriate Image Insufficient Information Mall Listing Improvement Other Listing Improvement
violation_reasonstringLicense ReasonThe reason for violation.
suggestionstringUpload licenseShopee provides you with suggestions for modifying items.
fix_deadline_timetimestamp1705227588Action required deadline. Empty if no deadline.
update_timetimestamp1705054788Latest update time.
deboost_detailsobject[]
violation_typestringProhibited ListingViolation types defined by Shopee. Các giá trị áp dụng: Prohibited Listing Counterfeit and IP Infringement Spam Inappropriate Image Insufficient Information Mall Listing Improvement Other Listing Improvement
violation_reasonstringWrong CategoryThe reason for violation.
suggestionstringThe item is in wrong category, please update to the suggested_categoryShopee provides you with suggestions for modifying items.
suggested_categoryobject[]
category_idint107478ID for Shopee suggested category.
category_namestringPersonal CareDefault name for Shopee suggested category.
fix_deadline_timetimestamp1705202227Action required deadline. Empty if no deadline.
update_timetimestamp1704943027Latest update time.
fail_errorstringIndicate error type if one element hit error.
fail_messagestringIndicate error details if one element hit error.

No Request Example Set.

], "deboost_details":[ { "violation_type":"Prohibited Listing", "violation_reason":"Wrong Category", "suggestion":"The item is in wrong category, please update to the suggested_category", "suggested_category":[ { "category_id":100005, "category_name":"Health" }, { "category_id":107478, "category_name":"Personal Care" } ], "update_time": 1704943027, "fix_deadline_time": 1705202227, } ] } ] } }

Partial Fail: { "message": null, "request_id": "80e9cf02db62236d9c05834a5e466a41", "response": { "item_list": [ { "item_id": 843025868, "item_name": "item 39 test", "item_status": "BANNED", "deboost": false, "item_status_details": [ { "fix_deadline_time": 1705228281, "suggestion": "Upload license", "update_time": 1705055481, "violation_reason": "License Reason", "violation_type": "Prohibited Listing" } ] } { "item_id": 843024518, "fail_error": "error_param", "fail_message": "Invalid request item_id" }, { "item_id": 43026711, "fail_error": "error_param", "fail_message": "Invalid request item_id" } ] } }