开始开发

术语介绍

• appId：每个企业都拥有唯一的appid
• appSecret：用于保证接口通讯安全的“钥匙”，为了保证数据的安全，secret务必不能泄漏
• rootCompanyId：每个企业都拥有唯一的id
• accessToken：用于API网关认证请求，每次请求的请求者身份信息

开发步骤

你可以通过以下步骤，使用appId与appSecret来请求易盘点相关接口。需要注意的是，所有的接口需使用https协议、UTF8编码。
注：查看接口说明中，参数中标注大写的单词，表示为需要替换的变量。

第一步：获取appId与appSecret

获取appId与appSecret信息可在管理后台“系统管理”-“系统对接”-“开放平台”-“开发者账号管理”下查看（需要有超级管理员权限）

第二步：访问令牌accessToken生成规则

调用API：/auth/getAccessToken

环境	地址	类型
正式环境	https://openapi.epandian.com/auth/getAccessToken	post请求

请求header

参数	类型	是否必填	描述	示例
Content-Type	String	是	application/x-www-form-urlencoded	application/x-www-form-urlencoded

请求参数

参数	类型	是否必填	最大长度	描述	示例
appId	String	是	32	易盘点分配给用户的应用id	ajVSNRanSHesNmEoIVAwnIwyxwrlQQRv
appSecret	String	是		易盘点分配给用户的应用secret	kHwzTrIDRa51Z0dXEYnb6QHfWF0ZgjWjuIgIWrlDVcoZGD0zUq2ep2D5a2dS8IKK

生成accessToken，有效期为2小时，超过时效系统会提示accessToken失效

生成的示例如下：

accessToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE1NzYyMzU5OTEsImhhc2hNYXAiOiJ7XCJhcHBJZFwiOlwiYWpWU05SYW5TSGVzTm1Fb0lWQXduSXd5eHdybFFRUnZcIixcInJvb3RDb21wYW55SWRcIjoxfSJ9.ud3AUDtG2Wv0eZfMyWcTzDP4tykFXBt6yjKE7BP6AJ0

这串字符串便是访问令牌accessToken

第三步：进行请求并获取返回值

参考具体接入接口说明访问易盘点开放的接口，正常的返回示例：

{
    "code": 0,
    "message": "操作成功",
    "data": ...
}

accessToken失效时，响应结果如下：

{
    "code": 19,
    "message": "accessToken已失效"
}

具体的响应码列表请参考易盘点开放平台响应码列表

第四步：开发具体逻辑

到这里，准备工作已经就绪，你可以继续阅读下面的接口文档了解更多关于易盘点提供的开放能力，并将这些能力与贵公司的系统进行对接。

如果你面对这些接口一时不知如何下手，欢迎下载我们开源的示例代码进行参考 :java版