当用户在搜索酒店时，我们需要根据用户是否可享有某项权益来进行相应价格的展示或隐藏，因此我们在酒店搜索时就需要判断用户是否享有某项权益。而由于酒店搜索频率过高，为提高搜索性能并降低第三方接口压力，当用户在搜索酒店时，淘宝会通过读取淘宝本地缓存的用户相关权益信息来进行判断。为提高缓存的准确性，当第三方有用户相关权益有变化时，通过调用淘宝此接口来更新淘宝本地缓存。此接口需要采用Top方式调用。
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| taobao_user_id | Number | 必须 | 123 | 淘宝用户id | |
| has_right | Boolean | 必须 | false | 表示用户是否有对应的权益，取值范围true、false | |
| right_type | Number | 必须 | 1 | 会员权益类型，1表示首住权益 |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| result | Boolean | true | result |
1 2 3 4 5 6 7 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);XhotelMemberrightUpdateRequest req = new XhotelMemberrightUpdateRequest();req.setTaobaoUserId(123L);req.setHasRight(false);req.setRightType(1L);XhotelMemberrightUpdateResponse rsp = client.execute(req, sessionKey);System.out.println(rsp.getBody()); |
1 2 3 | <xhotel_memberright_update_response> <result>true</result></xhotel_memberright_update_response> |
1 2 3 4 5 6 | <error_response> <code>50</code> <msg>Remote service error</msg> <sub_code>isv.invalid-parameter</sub_code> <sub_msg>非法参数</sub_msg></error_response> |
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| isv.401 | 用户ID非法 | 输入合法淘宝用户ID |
| isv.402 | 会员权益类型非法 | 输入合法会员权益类型 |
| isv.403 | 是否有会员权益参数非法 | 请输入true或者false |
| isv.500 | 系统错误 | 重试或联系酒店开发去解决 |
