轻易云
注册体验
POSThttp://api.guanyierp.com/rest/erp_openappkey + sessionkey + MD5 签名

接口调用规范与签名(appkey/sessionkey/sign)

管易云 C-ERP openAPI 调用规范:统一网关 /rest/erp_open,JSON 报文携带 appkey、sessionkey、method 与 sign;sign 为参数排序拼接后首尾加 secret 的 MD5。

来源：http://gop.guanyierp.com/hc/kb/article/1235511/
## 接口说明 管易云 C-ERP 的 openAPI 采用单一网关 + method 路由模式:所有接口 POST 到同一地址(V1 租户 http://api.guanyierp.com/rest/erp_open,V2 租户 http://v2.api.guanyierp.com/rest/erp_open),请求体为 UTF-8 JSON,以 method 字段区分业务接口(如 gy.erp.trade.get)。 ### 系统级参数 | 参数 | 说明 | | --- | --- | | appkey | 应用 key,【控制面板 → 应用授权 → 云ERP授权】中获取 | | sessionkey | 会话 key,与 appkey 同位置获取 | | method | 接口名 | | sign | 签名 | ### 签名步骤 1. 取除 sign 外的全部参数(系统级 + 业务级),按参数名升序排序; 2. 按 key + value 顺序拼接为字符串; 3. 首尾拼接应用密钥 secret; 4. 计算 MD5 得到 sign。 ### 响应与错误 响应 JSON 含 success(true/false);失败时返回 errorCode、subErrorCode、errorDesc、subErrorDesc 四层错误描述,例如 sessionkey 失效会返回 errorCode 为 Base Param error、subErrorCode 为 ErrorSessionKey。集成平台应把 subErrorCode 作为告警分类键。 ### 注意事项 - appkey/sessionkey/secret 三件套都在管易后台同一页面获取,V1 与 V2 租户网关不同,不能混用。 - 分页查询必须配合 page_no/page_size,返回 total 为条件下总条数。

代码示例

pseudo
params = { appkey, sessionkey, method: "gy.erp.trade.get", ...biz }
sign = md5(secret + concatSortedKV(params) + secret)
POST http://api.guanyierp.com/rest/erp_open
Content-Type: application/json; charset=UTF-8
{ ...params, sign }

错误码

错误码消息含义
Base Param error / ErrorSessionKey基本参数错误sessionkey 无效或过期,重新获取授权信息
Base Param error / ErrorAppKey基本参数错误appkey 错误或未授权
Sign error签名错误按签名规则重算 sign,检查排序与 secret