淘宝开放平台

登录
文档中心 > API类目 > 本地生活商户基础API

本地生活商户基础API

qimen.alibaba.qimen.alsc.item.spi.status.change (本地生活本地通商品状态变更外调)

本地生活-商户通-商品状态变更外调

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
trace_id String 必须 212bf6da16450967556093116eed54 请求id（唯一）三方按业务需求做幂等
item_id String 必须 663381390004 商品id
action String 必须 pause 操作类型：下架pause
punish_resean String 可选 图片异常，下架 操作原因。ps:重要,如果请求头中 punishBase64=true( 参考："true".equals (request.getHeader("punishBase64")) ) ，则该条原因为base64位加密，需要解密使用（参考：Base64.getDecoder().decode(xx)）
external_item_id String 可选 ex663381390004 外部商品id
punishBase64 String 可选 true 表示punish_resean是否是base64编码过的，如果为true获取punish_resean时需要自行进行解码

响应参数

名称 类型 示例值 描述
success Boolean true 请求成功标识true成功，false失败
data Data 结果数据
  • └ biz_success
  • Boolean
  • true
  • 业务处理成功
  • └ biz_msg
  • String
  • 成功
  • 业务处理结果信息
error_code String SYSTEM_ERROR 错误码
error_msg String 系统异常 错误信息

请求示例

{"punish_resean":"图片异常，下架","trace_id":"212bf6da16450967556093116eed54","item_id":"663381390004","action":"pause","punishBase64":"true","external_item_id":"ex663381390004"}

响应示例

{
    "success":true,
    "data":{
        "biz_success":true,
        "biz_msg":"成功"
    },
    "error_code":"SYSTEM_ERROR",
    "error_msg":"系统异常"
}

验签示例

{"error_msg":"Illegal request","success":"false","error_code":"sign-check-failure"}

错误码解释

错误码 错误描述 解决方案
response-body-parse-error

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部