ERP开放平台开发文档 - ERP开放接口API

平台入驻：
1.使用米合的管理员账户，可以在ERP开放平台获取开发对接的应用。包括开放平台的clientId与clientSecret。accessToken基于oauth2.0颁布，具有一定的使用时效，过期后需要重新获取。。附ERP开放平台地址:ERP开放平台
2.已经获取到上述clientId与clientSecret后，用户可以获取到访问资源服务器的 accessToken,accessToken有一定的有效期，过期后需要重新调用接口获取新的accessToken。

开发流程：
     1.使用米合的管理员账户登录ERP开放平台
     2.选择控制台，首次登录用户选择创建应用，已经申请过的用户直接可以看到应用信息。每个服务商只能申请一个应用。
     3.根据第二步拿到的应用Id，应用secret，引导用户授权，通过API换取accessToken。
     4.通过accessToken进行接口调用, 获取用户基本数据资源或帮助用户实现基本操作，接口调用成功，即返回业务数据，后续按需使用即可。

授权码模式授权流程：
此流程要求应用有Web Server应用，能够保存应用本身的密钥以及状态，可以通过https直接访问ERP的授权服务器。

1.拼接授权url(接口文档可参见授权管理API)

http://openapi.ruwii.com/api/oauth/authorize?clientId=XXXXXXXX

参数名	必选	类型	说明
clientId	是	String	API应用的clientId
state	否	String	自定义参数，回调时原样返回

2.引导用户登录授权
引导用户通过浏览器访问以上授权url，将弹出如下登录授权页面。用户输入账号、密码点“登录”按钮，即完成授权流程。
授权登录.png

3.获取授权码code
上图页面，若用户点“登录”按钮后，开放平台会跳转到服务商应用管理后台指定的redirectUri（授权码回调地址）并多添加参数code（浏览器地址栏），应用可以获取并使用该code去换取accessToken；
4.通过code换取accessToken(接口文档可参见授权管理API)
将code拼接为以下URL:

http://openapi.ruwii.com/api/oauth/token?clientId=xxxxxx&clientSecret=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&code=xxxxx

返回参数说明：

参数名	说明
accessToken	采用OAuth授权方式获取的accessToken授权码
tokenType	token类型
expiresIn	过期时间，单位为秒
scope	权限范围
refreshToken	刷新授权码

返回示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "accessToken": "6aaf5de8-3800-4725-8039-1c7e29f9b090",
        "tokenType": "bearer",
        "expiresIn": 17999,
        "scope": "read write",
        "refreshToken": "388c87d6-9969-4dbe-b11f-4fa59f24b925"
    }
}

API调用文档：
1.Get请求可以在url拼接参数，==注意：入参包含：[]{}等特殊符号，需要转义后传输，否则无法获取返回。

2.签名的非字符串参数，在计算签名的时候需要转为字符串加签。以下单接口为例，入参包含ConsigneeInfo对象，需要将ConsigneeInfo的值转为字符串。

3.用户需要按照米合的协议规范拼装一个正确的URL，通过Http请求到米合即能够获取到所需数据。主要流程包含：填写参数、生成签名、拼装HTTPS请求、发起请求、得到响应结果、解析结果。

4.公共参数

参数名	必选	类型	说明
accessToken	是	String	采用OAuth授权方式获取的accessToken授权码
clientId	是	String	API应用的clientId
sign	是	String	签名（算法请看下面的签名详解）
timestamp	是	Long	时间戳，毫秒
v	是	String	开放平台的API版本，目前是2.0

5.签名算法
为了防止API在调用过程中被恶意者拦截随意篡改，调用API是需要传入签名参数，服务端会根据请求参数对签名进行验证，判断请求参数是否合法。签名规则过程如下：
将所有请求参数（包括公共参数和业务参数）按照字母先后顺序排列，例如：accessToken,clientId,timestamp,v ，这些参数
排序为accessToken,clientId,timestamp,v
把所有参数名和参数值进行拼接，例如(x代表参数的值)： accessTokenxxxclientIdxxxtimestampxxxxxxvx
把clientSecret夹在字符串（上一步拼接串）的两端，例如：clientSecret+XXXX+clientSecret
使用MD5进行加密，再转化成大写，即为签名sign。

签名算法的Java代码实现：

6.接口HTTP请求的Java示例代码
本请求示例整合了签名算法，以HttpClient为基础调用接口的示例。