常见问题
API接入
Q：我们是PHP，.NET开发语言，怎么接入SDK？
A: 目前只提供java的SDK，其他语言请通过http的方式接入
Q：access_token过期时间
A：目前此解决方案产生的access_token是长久有效的
商品
Q：目前没有返回商家id，我们怎么去做商家订单聚合下单？
A：可以通过商品详情接口【https://www.cnsecc.com/doc_29485425.html】中的sellerOpenId进行商家识别，商家加密id1688唯一
Q：目前没有返回商家昵称返回，我们怎么去通过功能唤起旺旺和商家沟通？
A：可以通过接口解密
请求 URL
POST系统级输入参数
应用级输入参数
| 名称 | 类型 | 是否必须 | 描述 | 示例值 | |
|---|---|---|---|---|---|
| openUid | java.lang.String | 是 | 待解密的openUid |
返回结果
| 名称 | 类型 | 描述 | 示例值 | |
|---|---|---|---|---|
| wangwangNick | java.lang.String | 用以唤起旺旺的旺旺昵称 |
【https://www.cnsecc.com/doc_29485425.html】中的sellerOpenId，返回商家nick
Q：通过imageAddress图搜成功率不稳定，经常无数据返回
A: imageAddress仅推荐1688图片地址入参，其他域名不保证成功率，因为底层引擎需要从网络拉去图片，非1688图片地址容易超时，建议通过上传接口【https://www.cnsecc.com/doc_29485505.html】获取imageID，通过imageId进行图片搜索
Q：为什么有些商品没有翻译
A：翻译商品仅限于从多语言关键词搜索【https://www.cnsecc.com/doc_29485486.html】和多语言图搜【https://www.cnsecc.com/doc_29485406.html】中返回的商品，其他路径获取的offerId一般未翻译
Q：上传图片接口为什么没有imageId返回，或者返回0
A：请将图片压缩在100k左右，注意base64内容生成后检查下不需要【data:image/jpeg;base64,】这一串，/9后为有效字符
Q：请问图搜/词搜/商品详情接口中的country怎么传
A：目前解决方案仅支持英语，入参为country=en，其他语言目前不支持
Q：我们想筛选商品，你们目前支持哪些筛选条件
A：目前我们支持很多筛选条件，具体的筛选项参考以下表格，筛选项越少，筛选数据越多
参数示例：filter传入"shipIn24Hours,shipIn48Hours"，多个条件英文逗号分割；
枚举值：
筛选归属 | 筛选指标 | 类型详情 | 外部传参定义 |
履约质量 | 综合体验分 | 5星 | totalEpScoreLv1 |
4.5星-5.0星 | totalEpScoreLv2 | ||
4星-4.5星 | totalEpScoreLv3 | ||
4星以下 | totalEpScoreLv4 | ||
认证工厂 | 是否 | certifiedFactory | |
24小时揽收率 | <95% | getRate24HLv1 | |
>=95% | getRate24HLv2 | ||
>=99% | getRate24HLv3 | ||
48小时揽收率 | <95% | getRate48HLv1 | |
>=95% | getRate48HLv2 | ||
>=99% | getRate48HLv3 | ||
履约保障 | 当日发货 | 是否 | shipInToday |
24小时发货 | 是否 | shipIn24Hours | |
48小时发货 | 是否 | shipIn48Hours | |
7天无理由 | 是否 | noReason7DReturn | |
支持一件代发 | 是否 | isOnePsale | |
支持包邮(一件代发包邮) | 是否 | isOnePsaleFreePost |
Q：我们想进行商品排序，你们目前支持哪些条件排序，怎么请求
A：目前我们支持价格/复购率/月销量排序条件，具体的排序入参参考以下
参数示例：sort传入{"price":"asc"}。
枚举值：
定义 | 外部传参定义 | 排序类型 |
批发价 | price | asc-升序 desc-降序 |
复购率 | rePurchaseRate | |
月销量 | monthSold |
Q：为什么通过价格/复购率/月销量升序/降序，但是第二页比第一页高/低，整体并没有排序
A：因为词搜和图搜是针对想关心和同款度进行商品召回的为了不影响整体的召回效果，仅针对当前页做排序
Q：outMemberId是什么，我们要怎么传
A：outMemberId为注册账号模块中传的下游平台用户id，如果没有接入此模块，商品相关接口无需传此参数，忽略即可
Q：多语言图搜返回的页码不准
A:目前页码为预估页码，后续页码不再支持
Q：为什么显示有很多条数据，但是只能查2000条
A：目前底层一个query词或者一张图片，近支持查询2000个商品
Q：代发起批量是哪个字段
A：代发没有起批量，代发其实是指一件代发故1件就能下单，但是目前站内的商品详情页，在代发tap下还能看到起批量限制，是因为商家仅加入了分销没有将商品设置1件代发，所以这边显示的价格和起批量都是批发的设置
Q：价格有点多，批发价和代发价是哪个，我们怎么理解
A：目前价格梳理和解释汇总如下
price-批发价，不包邮，根据商家设置有起批量限制
jxhyPrice-一代代发精选货源价，包邮价格支持1件起批
pfJxhyPrice-批发精选货源价，不包邮价格2件起批
consignPrice-一件代发价，此时需要判断商品是否开通一件代发，否在在不为null的情况下为大市场批发价=price
Q：你们现在只提供英语，我们用不上，能否返回中文
A：目前多语言接口都是默认支持中文的，入参还是country=en，返回字段中包含中，英双语字段，以标题举例中文字段=subject，英文标题=subjectTrans
Q：你们的接口的价格看起来为什么没有在1688上看起来便宜
A：目前图搜/词搜/商品详情接口因为底层稳定性的限制，目前没有开放营销价格，故价格都是原价。但是下单时价格是享受营销价格后的最低价下单的
账号
Q： 通过账号注册能力注册的1688账号，在1688登录时点击发送验证码提示【获取次数已达上限，请明天再试】
A：一般是注册后，开发或者运营同学在国内环境验证是否能登陆时发生此现象，原因为手机号所属国家IP地址一天只允许发送一次验证码，请通过手机号所属国家网络重拾
Q：一个手机号码是不是只能注册一个帐户
A：是的
Q：账号注册接口提示【登录名重复】如何处理？
A：建议在outLoginId参数后面加上【_站点】，如运营国家是canada，机构站点名是plgjh，用户在机构网站登录名是johnnysaccount，则调1688注册接口时，传参为country=canada，site=plgjh，outLoginId=johnnysaccount_plgjh
交易
Q：之前对接过其他解决方案，接入新的解决方案交易是否能用老appkey调用老的接口（即不改造）
A：可以的，功能是通过appkey相互独立的，可以通过新的解决方案产生的新的appkey接入新的接口即可，老得能力按需改造
Q: 创建订单是的addressId从哪里获取？
A：收货地址说明
1、使用保存的收货地址传参示例：{"addressId":593861699}，其中addressId是调用“买家获取保存的收货地址信息列表”接口获取；
2、使用地址编码传参示例：{"address":"桃浦镇 金达路888号贸易8楼","phone": "0517-88990077","mobile": "15251667788","fullName": "张三","postCode": "000000","districtCode": "310107"}，其中districtCode需要调用“根据地址解析地区码”接口获取；
3、直接使用文本地址示例：{"address":"网商路699号","phone": "0517-88990077","mobile": "15251667788","fullName": "张三","postCode": "000000","areaText": "滨江区","townText": "","cityText": "杭州市","provinceText": "浙江省"}，省市区要传文本；
4、优先级说明，如果同时传入以上参数，系统按从1至3的优先级获取地址，满足1的条件下不会使用上示2中的参数，满足2的条件下不会使用上示3中的参数；
Q：提供了这么多支付方式我们应该用哪一种
A：按您1688账号在1688网站目前的支付习惯选取即可
推荐
-
-
QQ空间
-
新浪微博
-
人人网
-
豆瓣
