接口名称:网关出口消息,无接口名称
使用场景举例:当商品的状态发生变化时,口碑主动调用服务商的回调URL通知变更消息。回调URL设置详见“创建商品”、“修改商品”、“商品上下架”接口
REQUEST URL: http://example.com/gateway.do REQUEST METHOD: POST CONTENT: sign : Tp+HtPO24/ZsJZRaS30Nab4WBNQF1jlEoet1sMXPhfPt16b24uxi7xT+9xqVNBGy3TEfpXqGT7+fcwkGs+sVhh+CDh/MJvAlimy4NHYR5WCEWh1d55UDnLA4ZUPhaRY+Kq595gVfRtXLaXDT/1g7jOuzoFymD9APZThKQWiJvlY= biz_type : ITEM_CREATE request_id : 20151021D00509323424323 item_id : 2015110900076000000003205720 item_status : EFFECTIVE sign_type : RSA gmt_modified : 2015-11-09 16:38:24 notify_id : c7880f910fada2238c0c24de87fdb38k8s
注: 所有请求参数需经过编码处理,本示例给出的是未经编码处理时的请求参数
参数名 | 参数名称 | 类型 | 必填 | 描述 | 范例 |
---|---|---|---|---|---|
item_id | 内部商品ID | String(64) | 是 | 口碑体系内部商品的唯一标识 | 2015102700076000000002399624 |
request_id | 外部流水号 | String(64) | 是 | 支持英文字母和数字,由开发者自行定义(不允许重复),在门店notify消息中也会带有该参数,以此标明本次notify消息是对哪个请求的回应 | 20151021D00910fjusss111 |
item_status | 商品当前状态 | String | 是 | 该商品当前的状态,共有四个状态: INIT(初始化状态/创建但未上架) EFFECTIVE(上架/售卖中) PAUSE(暂停售卖) INVALID(下架/失效状态) |
EFFECTIVE |
gmt_modified | 修改时间 | Date | 是 | 本次请求商品的操作时间,格式:yyyy-MM-dd hh:mm:ss | 2015-10-24 10:45:00 |
biz_type | 通知业务类型 | String(32) | 是 | 商品通知传参值范围:ITEM_CREATE,ITEM_MODIFY,ITEM_STATE | ITEM_STATE |
notify_id | 通知校验ID | String(100) | 是 | 本次通知ID,技术参数,唯一标识一次通知 | c7880f910fada2238c0c24de87fdb38k8s |