1688开放平台-阿里

1688开放平台-阿里

专用API
【更新时间: 2024.07.23】 阿里1688开放平台是面对1688商家及采购代发买家日益繁杂的电商管理需求,基于大数据提供快捷、高效的应用工具
服务星级:2星
⭐ ⭐ 🌟 🌟 🌟 🌟 🌟
调用次数
0
集成人数
0
商用人数
0
! SLA: N/A
! 响应: N/A
! 适用于个人&企业
收藏
×
完成
取消
×
书签名称
确定
<
产品介绍
>

什么是阿里的1688开放平台?

阿里1688开放平台是面对1688商家及采购代发买家日益繁杂的电商管理需求,基于大数据提供快捷、高效的应用工具。

什么是阿里的1688开放平台?

由服务使用方的应用程序发起,以Restful风格为主、通过公网HTTP协议调用阿里的1688开放平台,从而实现程序的自动化交互,提高服务效率。

阿里的1688开放平台有哪些核心功能?

  1. 商品管理:提供自动重发、批量处理、一键复制、信息优化等功能,帮助商家高效管理商品信息。
  2. 订单管理:支持批量打印、批量发货、自动评价、进销存等功能,简化订单处理流程。
  3. 流量推广:提供网销宝优化、站外推广、搜索优化、无线引流等推广工具,助力商家提升店铺流量。
  4. 店铺装修:包括主图制作、装修模版、关联营销、详情设计等功能,帮助商家打造专业美观的店铺形象。
  5. 铺货分销:支持一键铺货、订单回流、批量支付、自动发货等功能,特别针对跨境电商和分销商,实现快速高效的采购和分销。
  6. 业务场景解决方案:深度开放B2B业务场景,提供完整的解决方案,让ISV(独立软件开发商)可以“拎包入住”,快速对接平台服务。
  7. API开发能力:提供模块化的接口集合,清晰的接口分类,方便开发伙伴进行二次开发和系统集成。

阿里的1688开放平台的核心优势是什么?

  1. 开放商业思维:平台秉持开放的心态,积极与全球服务开发者合作,共同推动商业生态的繁荣。
  2. 多样化的业务场景:支持丰富的业务场景,如跨境电商、铺货分销等,满足不同商家的多样化需求。
  3. 高效的工具集:提供一系列快捷、高效的电商管理工具,帮助商家简化流程,提升运营效率。
  4. 强大的技术支持:通过API开放、多语言SDK、云环境集成等技术资源,为开发者提供强大的技术支持。
  5. 清晰的盈利模式:为商家和服务商提供清晰的盈利模式,促进商业生态的可持续发展。
  6. 丰富的成功案例:平台已合作超过1600家服务商,拥有众多成功案例,证明了其市场价值和商业潜力。
  7. 优质的服务保障:提供一件代发包邮、快速发货、退换货保障等优质服务,增强买家信心,提升交易成功率。

在哪些场景会用到阿里的1688开放平台?

跨境电商

面向跨境电商平台开店的1688采购商,与ISV一起实现智能选款、一键铺货、自动下单、批量支付和订单信息同步等功能,帮助跨境平台卖家轻松实现在下游跨境电商平台销售,在1688平台快速完成采购的业务功能。

铺货分销

面向在下游电商或内容平台(如淘宝/抖音/快手/小红书/微信)开店的分销商,通过结合ISV数据化技术能力,实现1688优质代发货源一键智能多店铺货、下游订单自动回流采购,自动发货,帮助下游卖家轻松实现1688代发采购对接

货源推荐

提供一件代发包邮、48小时内发货、7天包退等优质代发服务保障货源品池,同时商品价格较下游零售面价平均低20%以上,结合ISV的用户触达渠道,帮助1688代发分销买家实现更高利润空间的优质货源采购对接

<
使用指南
>

一、注册成为开发者

注册开发者身份,需同时具备以下两个条件

1、具备一个阿里巴巴中国站帐号

2、必须绑定了通过个人或者企业实名认证的支付宝帐号;个人开发者必须绑定通过个人实名认证的支付宝账号,企业开发者必须绑定通过商家认证的支付宝账号

具备这两个条件之后就可以在1688开放平台注册成为开发者

 

二、注册应用

注册成为开发者之后就可以在1688开放平台上注册应用

应用注册成功后isv可以获得此app的关键信息,包括appkey、app密钥以及流量上限(5000)。

注意:appkey和app密钥相当于用户名和密码,请不要随意泄露

 

三、开发测试

说明:如果你的web app要在阿里巴巴应用市场售卖,那么请选择“托管式授权”,否则请选择“WEB授权”;如果是客户端app,请选择“客户端授权”。请参考授权分类

1、托管式授权方式: 
对于托管式授权开发方式而言,您的app需要与应用市场配合完成授权过程,那么您可以参考如下授权流程编写代码

(1)用户授权以及api调用,对应图中黄色部分。用户通过应用市场订购你的app然后初次访问时,应用市场会302跳转到你的app入口url,同时带上参数code。 所以代码中不需要涉及获取code这一步,只需要使用getToken接口拿应用市场传过来的code换取accessToken, 并将getToken返回信息保存下来, 然后用返回信息中的accessToken作为参数调用api(参考 API调用说明 ) 在app测试过程中可以通过 授权测试工具 生成一个code,然后作为参数访问应用入口即可测试。 
注意:必须以getToken返回信息中的refreshToken为主,如果跟本地保存的refreshToken不一样,那么本地的refreshToken废弃。

(2)特殊情况处理,对应图中绿色部分。主要是accessToken失效的处理。 如果accessToken失效,那么就需要用保存的refreshToken调用getToken接口生成一个新的accessToken;

(3)错误处理,对应图中红色部分。如果出现签名错误、时间戳错误等异常情况,最好是能够在日志中记录当前调用的url以及参数,这样即使在出现问题时也能快速查找并解决问题。(参考 常见问题 

 

2、WEB授权方式:

对于WEB授权开发方式而言,您的app不会在阿里巴巴应用市场售卖,那么您需要完成完整的授权过程,请参考如下授权流程

(1)用户授权。请按照授权说明中的WEB授权流程编写具体代码。

(2)特殊情况处理。主要是accessToken失效以及refreshToken过期的处理。 如果accessToken失效,那么就需要用保存的refreshToken调用getToken接口生成一个新的accessToken; 如果refreshToken失效,那么需要重新进行第一步。

(3)错误处理。如果出现签名错误、时间戳错误等api调用失败的情况,最好是能够在日志中记录当前调用的url以及参数,这样即使在出现问题时也能快速查找并解决问题。(参考常见问题

 

3、客户端授权方式

对于客户端授权开发方式而言,跟WEB授权类似,也需要完成完整的授权过程,请参考如下授权流程

(1)用户授权。请按照授权说明中的客户端授权流程编写具体代码

(2)特殊情况处理。主要是accessToken失效以及refreshToken过期的处理。 如果accessToken失效,那么就需要用保存的refreshToken调用getToken接口生成一个新的accessToken; 如果refreshToken失效,那么需要重新进行第一步。

(3)错误处理。如果出现签名错误、时间戳错误等api调用失败的情况,最好是能够在日志中记录当前调用的url以及参数,这样即使在出现问题时也能快速查找并解决问题。(参考常见问题

 

四、提交申请

应用测试无误后还需要填写更为详细的app信息才能提交上线申请

1、如果您的app需要在应用市场在线售卖,那么审核通过后会在应用市场进行上架配置;

2、如果您的app是通过自有渠道销售或者仅供自用,那么审核通过后在应用市场不显示。

注意:app提交审核之后将无法修改,请确认app测试通过并且重要信息填写无误后再提交审核 

 

五、审核并上线

提交审核申请之后,阿里巴巴工作人员会在一周内进行审核

如果审核通过则可在相关平台提供服务;如果不通过,需要isv修改app然后再次提交申请

应用审核关注的重点是应用功能和安全性,请isv关注应用接入审核规则

app审核通过并在应用市场配置后即可上线,有以下两点需要注意

1、app流量上限由原来的5000增加到100000,如果在app使用过程中发现流量不够,可以向开放平台申请扩充

2、app的基本信息中有部分信息可以修改,包括应用简介、应用详情、客服旺旺、客服邮箱以及客服电话。修改后同样需要提交审核才能正式生效。

详情参考:https://open.1688.com/api/apidoclist.htm?id=624392

<
产品问答
>
?
通过浏览器访问直接报500错误
很有可能是使用ie浏览器的原因,建议使用chrome或者firefox浏览器,这样可以清晰地看到返回的错误信息
?
签名错误
返回结果为:{"error_code":400,"error_message":"com.alibaba.openapi.gateway.exceptions.RequestValidateException:Invalid signature.","exception":"com.alibaba.openapi.gateway.exceptions.RequestValidateException: Invalid signature."} a. 如果请求参数中带中文或者日期(如:20120228212041422+0800),所有参数需在UrlEncode之前计算签名,也就是用原始的参数计算签名;签名完成后,在请求前应对参数用utf-8进行UrlEncode,再访问阿里巴巴开放平台。可以使用签名测试工具测试签名的正确性 b. 如果根据当前url和请求参数计算的签名和签名测试工具一致,那么只可能是传到后端服务的参数与代码中的参数不一致,可能原因是使用 get请求的参数内容太长(换成post请求试试),也可能是特殊字符的编码格式不对(设置Content-type为"application/x-www-form-urlencoded; charset=UTF-8"试试) c. 如果请求中涉及文件上传,文件字节流参数不参与签名计算;另外,需指定请求的form enctype属性为multipart/form-data
?
app访问频率超限
返回信息{"error_code":"403","error_message":"Beyond the app call frequency limit","exception":"Beyond the app call frequency limit"} 通常app都会有访问频率的限制,可以在阿里巴巴开放平台开发者中心看到自己的app的每日调用频率上限, 这个值代表单台服务器24小时内访问的频率上限。一旦在某一台服务器上通过此app调用api 的次数超过这个上限,那么就会报这个错误,这时候需要联系开放平台管理员修改调用频率上限。
?
app怎么获取临时令牌code
对于托管式授权方式,由于app托管在应用市场,那么用户在进入app应用时,阿里巴巴开放平台会302跳转到app的入口地址,同时会附带参数code。App在跳转的http请求中,可取得此参数。 对于客户端或者web端授权方式,需要app自己发起获取code的请求,用户登录成功后就会返回code。
?
code错误
返回结果为:{"error":"invalid_request","error_description":"wrong authorizationCode:cb681549-c8de-441c-b96b-e0e224fb28e0"} 可能原因: a. code已失效,为了保证用户数据安全,临时令牌code的有效期为2分钟。App在获得令牌后,需同步调用getToken接口,获取token。 b. 用该code多次获取token。code为一次性消费的临时令牌,调用一次getToken后,此临时令牌便已失效。 c. 获取code使用的appKey和获取token使用的appKey不一致。
?
未使用post调用getToken接口
返回结果为:{"error":"invalid_request","error_description":"Method not set to POST."} oauth2协议规定,getToken必须为post提交
?
未使用https调用getToken接口
返回结果为:{"error_code":"400","error_message":"API unsupport the channel: http.","exception":"API unsupport the channel: http."} getToken必须为https请求
?
调用getToken接口时缺少redirect_uri参数
返回结果为:{"error":"invalid_request","error_description":"Missing parameters: redirect_uri"} getToken的参数中redirect_uri必须要填
?
缺少签名
返回结果为:{"error_code":"401","error_message":"Request need signature","exception":"Request need signature"} 原因是当前访问的api 需要签名,但是传入的参数中没有_aop_signature。在调用api 时要注意看文档中的系统级输入参数,在其中可以看到请求签名是否必须
?
accessToken过期
返回结果为:{"error_code":"401","error_message":"Request need user authorized","exception":"Request need user authorized"} 原因是传入的参数access_token已经过期,需要用refreshToken重新换取accessToken。
?
没有授权
返回结果为:{"error_code":"401","error_message":"Request need user authenticated","exception":"Request need user authenticated"} 原因是当前访问的api 需要用户授权才能访问,但是没有传入参数access_token。在调用api 时要注意看对于api 文档中的"API用户授权类型",在其中可以看到是否需要授权。
?
refreshToken错误
返回结果为:{"error":"invalid_request","error_description":"wrong refreshToken"} 原因一般有两种:refreshToken错误,refreshToken过期
?
没有传refreshToken参数
返回结果为:{"error":"invalid_request","error_description":"Missing parameters: refresh_token"} 原因是在用refreshToken换accessToken时refreshToken参数为空,请检查post请求的refreshToken参数是否遗漏
?
密钥校验不通过
返回结果为:{"error":"unauthorized_client","error_description":"getToken secret error! client_id: YOUR_APPKEY"} 原因是在使用getToken接口时传入的client_secret参数跟client_id不匹配,也就是没有传入client_id(appkey)对应的密钥,导致后台在校验密钥时发现与预期的密钥不符,所以报错。 可能原因有以下两种:一是传入的client_secret错误,二是传入了正确的密钥但是在post调用时没有进行urlencode。
?
时间戳错误
返回结果为{"error_code":"400","error_message":"com.alibaba.openapi.exception.request.RequestValidateException: Request is expired.","exception":"com.alibaba.openapi.exception.request.RequestValidateException: Request is expired."} 时间戳参数代表着访问api 的时间,只要传入了这个参数,那么每次访问时系统都会把这个参数与当前时间进行对比,如果二者相差超过了时间戳误差的话,就会报这个错误。 所以对于这个时间戳参数有三点需要注意:(1)首先要阅读api文档的系统级输入参数一节,看api 的访问是否需要时间戳,如果不需要就没有必要传入这个参数。(2)如果api 要求必须传入时间戳,那么最好是先进行时间校准然后再调用api。(3)时间戳的内容为时间的毫秒值,在java中转换方式为new Date().getTime(),其他编程语言也有类似的转换方式 时间戳校准方法:调用currentTime接口(http://gw.open.1688.com/openapi/param2/1/system/currentTime/{YOUR_APP_KEY})获取系统时间,然后跟本地取到的当前时间对比取二者的差,这样就得到了本地时间与阿里巴巴服务器的时间差;然后在调用api 时把当前时间加上这个时间差作为时间戳参数
?
缺少时间戳参数
返回结果为{"error_code":"400","error_message":"API need time stamp verify, so request must has _aop_timestamp. ","exception":"API need time stamp verify, so request must has _aop_timestamp. "} 原因是api 必须要有时间戳参数,但是调用时没有传入这个参数
?
调用api 时使用的appkey不存在或者未通过审核
返回结果为{"error_code":"400","error_message":"com.alibaba.openapi.exception.request.RequestValidateException: Invalid appKey, unsport appKey: xxx","exception":"com.alibaba.openapi.exception.request.RequestValidateException: Invalid appKey, unsport appKey: xxx"} 对应的app不存在或者未通过审核
<
关于我们
>
1688开放平台,依托B2B海量用户资源以及强大的平台优势,是为阿里巴巴买卖家提供开放服务的重要平台,帮助商家提升经营能力、拓宽生意渠道、提高办公效率;帮助买家提升选品、下单效率,降低采购成本等。 我们致力于为企业构建智能经营服务网络,开放和集成企业经营生命周期所需的专业服务,解决企业经营问题。赋能生态伙伴以灵活、安全及低成本形式进行系统对接,信息互联。
联系信息
服务时间: 09:00--18:00
电话号码: 400-800-1688

文化和价值观

使命
让天下没有难做的生意。
愿景
追求成为一家活102年的好公司。我们的愿景是让客户相会、工作和生活在阿里巴巴。
 
价值观
客户第一,员工第二,股东第三
因为信任,所以简单
唯一不变的是变化
今天最好的表现是明天最低的要求
此时此刻,非我莫属
认真生活,快乐工作
 
里程碑
阿里巴巴集团由曾担任英语教师的马云与其他来自不同背景的伙伴共18人,于1999年在中国杭州创立。从一开始,所有创始人就深信互联网能够创造公平的环境,让小企业通过创新与科技拓展业务,并更有效地参与中国及国际市场竞争。自推出让中国中小企业接触全球买家的首个网站以来,阿里巴巴作为控股公司持有六大业务集团:淘天集团、阿里国际数字商业集团、云智能集团、本地生活集团、菜鸟集团、大文娱集团,以及各种其他业务。

关于1688开放平台

   1688开放平台,依托B2B海量用户资源以及强大的平台优势,是为阿里巴巴买卖家提供开放服务的重要平台,帮助商家提升经营能力、拓宽生意渠道、提高办公效率;帮助买家提升选品、下单效率,降低采购成本等。

   

   我们致力于为企业构建智能经营服务网络,开放和集成企业经营生命周期所需的专业服务,解决企业经营问题。赋能生态伙伴以灵活、安全及低成本形式进行系统对接,信息互联。

 

我们服务哪些伙伴

    1688开放平台服务两类最基础的伙伴,为买卖家提供服务工具的1688服务商(isv),以及有1688电商系统对接需求并有开发能力的买卖家。

    · 第一种 - 合作伙伴销售服务模式:服务商伙伴使用开放平台的场景解决方案(api)开发工具或服务,并在1688服务市场售卖给买卖家。提供包括但不限于电商经营所需的管理工具和买家采购提效工具或服务,如商品管理,订单管理,电商ERP等工具。

    · 第二种 - 买卖家自开发模式:有开发能力的1688商家或买家,使用平台解决方案,开发满足自身电商场景所需的工具,如买家采购场景,以及部分垂直业务的开放场景,如跨境电商、社交电商等,此场景仅限企业用户自开发自使用,禁止私自线下售卖或授权其他企业使用,如因此产生的数据泄漏、法律责任由开发者全权承担。

 

我们将提供哪些服务

    我们为以上开发者伙伴提供了基础的产品研发平台,包括组成场景解决方案的API,消息,介绍,帮助文档等,以及研发辅助相关的测试工具、咨询工具、信息反馈渠道等,帮助合作伙伴解决研发问题。

    我们开放的解决方案主要是围绕商家电商经营和买家采购场景,如常见的商家场景有:订单管理解决方案、商品管理解决方案等;常见的买家场景有:采购解决方案,跨境采购解决方案,社交电商解决方案等。

    另外,我们还开放专业智能技术作为特色增值能力,通过将人工智能和垂直产业相结合,帮助合作伙伴用技术手段在产品价值,如智能抠图,智能搜索等;

<
最可能同场景使用的其他API
>
API接口列表
<
使用指南
>

一、注册成为开发者

注册开发者身份,需同时具备以下两个条件

1、具备一个阿里巴巴中国站帐号

2、必须绑定了通过个人或者企业实名认证的支付宝帐号;个人开发者必须绑定通过个人实名认证的支付宝账号,企业开发者必须绑定通过商家认证的支付宝账号

具备这两个条件之后就可以在1688开放平台注册成为开发者

 

二、注册应用

注册成为开发者之后就可以在1688开放平台上注册应用

应用注册成功后isv可以获得此app的关键信息,包括appkey、app密钥以及流量上限(5000)。

注意:appkey和app密钥相当于用户名和密码,请不要随意泄露

 

三、开发测试

说明:如果你的web app要在阿里巴巴应用市场售卖,那么请选择“托管式授权”,否则请选择“WEB授权”;如果是客户端app,请选择“客户端授权”。请参考授权分类

1、托管式授权方式: 
对于托管式授权开发方式而言,您的app需要与应用市场配合完成授权过程,那么您可以参考如下授权流程编写代码

(1)用户授权以及api调用,对应图中黄色部分。用户通过应用市场订购你的app然后初次访问时,应用市场会302跳转到你的app入口url,同时带上参数code。 所以代码中不需要涉及获取code这一步,只需要使用getToken接口拿应用市场传过来的code换取accessToken, 并将getToken返回信息保存下来, 然后用返回信息中的accessToken作为参数调用api(参考 API调用说明 ) 在app测试过程中可以通过 授权测试工具 生成一个code,然后作为参数访问应用入口即可测试。 
注意:必须以getToken返回信息中的refreshToken为主,如果跟本地保存的refreshToken不一样,那么本地的refreshToken废弃。

(2)特殊情况处理,对应图中绿色部分。主要是accessToken失效的处理。 如果accessToken失效,那么就需要用保存的refreshToken调用getToken接口生成一个新的accessToken;

(3)错误处理,对应图中红色部分。如果出现签名错误、时间戳错误等异常情况,最好是能够在日志中记录当前调用的url以及参数,这样即使在出现问题时也能快速查找并解决问题。(参考 常见问题 

 

2、WEB授权方式:

对于WEB授权开发方式而言,您的app不会在阿里巴巴应用市场售卖,那么您需要完成完整的授权过程,请参考如下授权流程

(1)用户授权。请按照授权说明中的WEB授权流程编写具体代码。

(2)特殊情况处理。主要是accessToken失效以及refreshToken过期的处理。 如果accessToken失效,那么就需要用保存的refreshToken调用getToken接口生成一个新的accessToken; 如果refreshToken失效,那么需要重新进行第一步。

(3)错误处理。如果出现签名错误、时间戳错误等api调用失败的情况,最好是能够在日志中记录当前调用的url以及参数,这样即使在出现问题时也能快速查找并解决问题。(参考常见问题

 

3、客户端授权方式

对于客户端授权开发方式而言,跟WEB授权类似,也需要完成完整的授权过程,请参考如下授权流程

(1)用户授权。请按照授权说明中的客户端授权流程编写具体代码

(2)特殊情况处理。主要是accessToken失效以及refreshToken过期的处理。 如果accessToken失效,那么就需要用保存的refreshToken调用getToken接口生成一个新的accessToken; 如果refreshToken失效,那么需要重新进行第一步。

(3)错误处理。如果出现签名错误、时间戳错误等api调用失败的情况,最好是能够在日志中记录当前调用的url以及参数,这样即使在出现问题时也能快速查找并解决问题。(参考常见问题

 

四、提交申请

应用测试无误后还需要填写更为详细的app信息才能提交上线申请

1、如果您的app需要在应用市场在线售卖,那么审核通过后会在应用市场进行上架配置;

2、如果您的app是通过自有渠道销售或者仅供自用,那么审核通过后在应用市场不显示。

注意:app提交审核之后将无法修改,请确认app测试通过并且重要信息填写无误后再提交审核 

 

五、审核并上线

提交审核申请之后,阿里巴巴工作人员会在一周内进行审核

如果审核通过则可在相关平台提供服务;如果不通过,需要isv修改app然后再次提交申请

应用审核关注的重点是应用功能和安全性,请isv关注应用接入审核规则

app审核通过并在应用市场配置后即可上线,有以下两点需要注意

1、app流量上限由原来的5000增加到100000,如果在app使用过程中发现流量不够,可以向开放平台申请扩充

2、app的基本信息中有部分信息可以修改,包括应用简介、应用详情、客服旺旺、客服邮箱以及客服电话。修改后同样需要提交审核才能正式生效。

详情参考:https://open.1688.com/api/apidoclist.htm?id=624392

<
依赖服务
>
<
产品问答
>
?
通过浏览器访问直接报500错误
很有可能是使用ie浏览器的原因,建议使用chrome或者firefox浏览器,这样可以清晰地看到返回的错误信息
?
签名错误
返回结果为:{"error_code":400,"error_message":"com.alibaba.openapi.gateway.exceptions.RequestValidateException:Invalid signature.","exception":"com.alibaba.openapi.gateway.exceptions.RequestValidateException: Invalid signature."} a. 如果请求参数中带中文或者日期(如:20120228212041422+0800),所有参数需在UrlEncode之前计算签名,也就是用原始的参数计算签名;签名完成后,在请求前应对参数用utf-8进行UrlEncode,再访问阿里巴巴开放平台。可以使用签名测试工具测试签名的正确性 b. 如果根据当前url和请求参数计算的签名和签名测试工具一致,那么只可能是传到后端服务的参数与代码中的参数不一致,可能原因是使用 get请求的参数内容太长(换成post请求试试),也可能是特殊字符的编码格式不对(设置Content-type为"application/x-www-form-urlencoded; charset=UTF-8"试试) c. 如果请求中涉及文件上传,文件字节流参数不参与签名计算;另外,需指定请求的form enctype属性为multipart/form-data
?
app访问频率超限
返回信息{"error_code":"403","error_message":"Beyond the app call frequency limit","exception":"Beyond the app call frequency limit"} 通常app都会有访问频率的限制,可以在阿里巴巴开放平台开发者中心看到自己的app的每日调用频率上限, 这个值代表单台服务器24小时内访问的频率上限。一旦在某一台服务器上通过此app调用api 的次数超过这个上限,那么就会报这个错误,这时候需要联系开放平台管理员修改调用频率上限。
?
app怎么获取临时令牌code
对于托管式授权方式,由于app托管在应用市场,那么用户在进入app应用时,阿里巴巴开放平台会302跳转到app的入口地址,同时会附带参数code。App在跳转的http请求中,可取得此参数。 对于客户端或者web端授权方式,需要app自己发起获取code的请求,用户登录成功后就会返回code。
?
code错误
返回结果为:{"error":"invalid_request","error_description":"wrong authorizationCode:cb681549-c8de-441c-b96b-e0e224fb28e0"} 可能原因: a. code已失效,为了保证用户数据安全,临时令牌code的有效期为2分钟。App在获得令牌后,需同步调用getToken接口,获取token。 b. 用该code多次获取token。code为一次性消费的临时令牌,调用一次getToken后,此临时令牌便已失效。 c. 获取code使用的appKey和获取token使用的appKey不一致。
?
未使用post调用getToken接口
返回结果为:{"error":"invalid_request","error_description":"Method not set to POST."} oauth2协议规定,getToken必须为post提交
?
未使用https调用getToken接口
返回结果为:{"error_code":"400","error_message":"API unsupport the channel: http.","exception":"API unsupport the channel: http."} getToken必须为https请求
?
调用getToken接口时缺少redirect_uri参数
返回结果为:{"error":"invalid_request","error_description":"Missing parameters: redirect_uri"} getToken的参数中redirect_uri必须要填
?
缺少签名
返回结果为:{"error_code":"401","error_message":"Request need signature","exception":"Request need signature"} 原因是当前访问的api 需要签名,但是传入的参数中没有_aop_signature。在调用api 时要注意看文档中的系统级输入参数,在其中可以看到请求签名是否必须
?
accessToken过期
返回结果为:{"error_code":"401","error_message":"Request need user authorized","exception":"Request need user authorized"} 原因是传入的参数access_token已经过期,需要用refreshToken重新换取accessToken。
?
没有授权
返回结果为:{"error_code":"401","error_message":"Request need user authenticated","exception":"Request need user authenticated"} 原因是当前访问的api 需要用户授权才能访问,但是没有传入参数access_token。在调用api 时要注意看对于api 文档中的"API用户授权类型",在其中可以看到是否需要授权。
?
refreshToken错误
返回结果为:{"error":"invalid_request","error_description":"wrong refreshToken"} 原因一般有两种:refreshToken错误,refreshToken过期
?
没有传refreshToken参数
返回结果为:{"error":"invalid_request","error_description":"Missing parameters: refresh_token"} 原因是在用refreshToken换accessToken时refreshToken参数为空,请检查post请求的refreshToken参数是否遗漏
?
密钥校验不通过
返回结果为:{"error":"unauthorized_client","error_description":"getToken secret error! client_id: YOUR_APPKEY"} 原因是在使用getToken接口时传入的client_secret参数跟client_id不匹配,也就是没有传入client_id(appkey)对应的密钥,导致后台在校验密钥时发现与预期的密钥不符,所以报错。 可能原因有以下两种:一是传入的client_secret错误,二是传入了正确的密钥但是在post调用时没有进行urlencode。
?
时间戳错误
返回结果为{"error_code":"400","error_message":"com.alibaba.openapi.exception.request.RequestValidateException: Request is expired.","exception":"com.alibaba.openapi.exception.request.RequestValidateException: Request is expired."} 时间戳参数代表着访问api 的时间,只要传入了这个参数,那么每次访问时系统都会把这个参数与当前时间进行对比,如果二者相差超过了时间戳误差的话,就会报这个错误。 所以对于这个时间戳参数有三点需要注意:(1)首先要阅读api文档的系统级输入参数一节,看api 的访问是否需要时间戳,如果不需要就没有必要传入这个参数。(2)如果api 要求必须传入时间戳,那么最好是先进行时间校准然后再调用api。(3)时间戳的内容为时间的毫秒值,在java中转换方式为new Date().getTime(),其他编程语言也有类似的转换方式 时间戳校准方法:调用currentTime接口(http://gw.open.1688.com/openapi/param2/1/system/currentTime/{YOUR_APP_KEY})获取系统时间,然后跟本地取到的当前时间对比取二者的差,这样就得到了本地时间与阿里巴巴服务器的时间差;然后在调用api 时把当前时间加上这个时间差作为时间戳参数
?
缺少时间戳参数
返回结果为{"error_code":"400","error_message":"API need time stamp verify, so request must has _aop_timestamp. ","exception":"API need time stamp verify, so request must has _aop_timestamp. "} 原因是api 必须要有时间戳参数,但是调用时没有传入这个参数
?
调用api 时使用的appkey不存在或者未通过审核
返回结果为{"error_code":"400","error_message":"com.alibaba.openapi.exception.request.RequestValidateException: Invalid appKey, unsport appKey: xxx","exception":"com.alibaba.openapi.exception.request.RequestValidateException: Invalid appKey, unsport appKey: xxx"} 对应的app不存在或者未通过审核
<
关于我们
>
1688开放平台,依托B2B海量用户资源以及强大的平台优势,是为阿里巴巴买卖家提供开放服务的重要平台,帮助商家提升经营能力、拓宽生意渠道、提高办公效率;帮助买家提升选品、下单效率,降低采购成本等。 我们致力于为企业构建智能经营服务网络,开放和集成企业经营生命周期所需的专业服务,解决企业经营问题。赋能生态伙伴以灵活、安全及低成本形式进行系统对接,信息互联。
联系信息
服务时间: 09:00--18:00
电话号码: 400-800-1688

文化和价值观

使命
让天下没有难做的生意。
愿景
追求成为一家活102年的好公司。我们的愿景是让客户相会、工作和生活在阿里巴巴。
 
价值观
客户第一,员工第二,股东第三
因为信任,所以简单
唯一不变的是变化
今天最好的表现是明天最低的要求
此时此刻,非我莫属
认真生活,快乐工作
 
里程碑
阿里巴巴集团由曾担任英语教师的马云与其他来自不同背景的伙伴共18人,于1999年在中国杭州创立。从一开始,所有创始人就深信互联网能够创造公平的环境,让小企业通过创新与科技拓展业务,并更有效地参与中国及国际市场竞争。自推出让中国中小企业接触全球买家的首个网站以来,阿里巴巴作为控股公司持有六大业务集团:淘天集团、阿里国际数字商业集团、云智能集团、本地生活集团、菜鸟集团、大文娱集团,以及各种其他业务。

关于1688开放平台

   1688开放平台,依托B2B海量用户资源以及强大的平台优势,是为阿里巴巴买卖家提供开放服务的重要平台,帮助商家提升经营能力、拓宽生意渠道、提高办公效率;帮助买家提升选品、下单效率,降低采购成本等。

   

   我们致力于为企业构建智能经营服务网络,开放和集成企业经营生命周期所需的专业服务,解决企业经营问题。赋能生态伙伴以灵活、安全及低成本形式进行系统对接,信息互联。

 

我们服务哪些伙伴

    1688开放平台服务两类最基础的伙伴,为买卖家提供服务工具的1688服务商(isv),以及有1688电商系统对接需求并有开发能力的买卖家。

    · 第一种 - 合作伙伴销售服务模式:服务商伙伴使用开放平台的场景解决方案(api)开发工具或服务,并在1688服务市场售卖给买卖家。提供包括但不限于电商经营所需的管理工具和买家采购提效工具或服务,如商品管理,订单管理,电商ERP等工具。

    · 第二种 - 买卖家自开发模式:有开发能力的1688商家或买家,使用平台解决方案,开发满足自身电商场景所需的工具,如买家采购场景,以及部分垂直业务的开放场景,如跨境电商、社交电商等,此场景仅限企业用户自开发自使用,禁止私自线下售卖或授权其他企业使用,如因此产生的数据泄漏、法律责任由开发者全权承担。

 

我们将提供哪些服务

    我们为以上开发者伙伴提供了基础的产品研发平台,包括组成场景解决方案的API,消息,介绍,帮助文档等,以及研发辅助相关的测试工具、咨询工具、信息反馈渠道等,帮助合作伙伴解决研发问题。

    我们开放的解决方案主要是围绕商家电商经营和买家采购场景,如常见的商家场景有:订单管理解决方案、商品管理解决方案等;常见的买家场景有:采购解决方案,跨境采购解决方案,社交电商解决方案等。

    另外,我们还开放专业智能技术作为特色增值能力,通过将人工智能和垂直产业相结合,帮助合作伙伴用技术手段在产品价值,如智能抠图,智能搜索等;

<
最可能同场景使用的其他API
>