轻易云
注册体验

领星ERP常见问题案例接口

所属平台
领星ERP
类型
DOC
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
1. 获取access_token时报以下错误 ```text { "code": "0001001", "msg": "rsa private decrypt error", "data": null } ``` 原因:因为appSecret中可能有特殊字符,在传输中会转义,因此appSecret用Rsa解密时报错。 解决方法: appSecret利用urlencode.encode()进行转义后传输。 2. 生成签名不正确 ```text { "code": "2001006", "msg": " api sign not correct", "data": { "throwable": " api sign not correct", "throwTime": "2022-01-20 15:37:55", "message": null, "stackTrace": null, "metadata": {} } } ``` 原因:生成的签名不正确。 解决方法: 1、检查参与生成签名的参数是否正确。 2、当参数的值为空时,不需要把该参数代入计算签名。 3、参与签名的时间戳长度取10位。 4、检查签名是否进行了URLEncoder.encode()进行url字符转义。 5、POST 请求的 app_key、timestamp、URL 编码后的 sign 放在 URL Query 中,业务参数放在请求体中;access_token 推荐通过 Authorization: Bearer <access_token> 请求头传递。无论 token 放在哪里,都须以 access_token 为参数名参与签...
更新日期
2026-11-21

常见问题案例

DOC/new/guides/qa/
加工厂
{
  "operation": {
    "method": "DOC",
    "path": null
  },
  "host": "https://openapi.lingxing.com",
  "content": "1. 获取access_token时报以下错误\n\n```text\n{\n    \"code\": \"0001001\",\n    \"msg\": \"rsa private decrypt error\",\n    \"data\": null\n}\n```\n\n原因:因为appSecret中可能有特殊字符,在传输中会转义,因此appSecret用Rsa解密时报错。\n\n解决方法: appSecret利用urlencode.encode()进行转义后传输。\n\n2. 生成签名不正确\n\n```text\n{\n    \"code\": \"2001006\",\n    \"msg\": \" api sign not correct\",\n    \"data\": {\n        \"throwable\": \" api sign not correct\",\n        \"throwTime\": \"2022-01-20 15:37:55\",\n        \"message\": null,\n        \"stackTrace\": null,\n        \"metadata\": {}\n    }\n}\n```\n\n原因:生成的签名不正确。\n\n解决方法:\n\n1、检查参与生成签名的参数是否正确。\n\n2、当参数的值为空时,不需要把该参数代入计算签名。\n\n3、参与签名的时间戳长度取10位。\n\n4、检查签名是否进行了URLEncoder.encode()进行url字符转义。\n\n5、POST 请求的 app_key、timestamp、URL 编码后的 sign 放在 URL Query 中,业务参数放在请求体中;access_token 推荐通过 Authorization: Bearer <access_token> 请求头传递。无论 token 放在哪里,都须以 access_token 为参数名参与签名一次,Authorization 字段名和 Bearer 前缀不参与签名。Query token 方式仅在过渡期兼容,将于 2027 年 1 月 1 日下线。\n\n6、传入body参数若为数组、List等集合类型时,需要将其先转入为String类型后再进行传入从而生成sign;在生成sign之后,需要重新将数组、List集合本身再次进行覆盖,防止出现参数不合法的问题;参考SDK下载-Java代码示例com.asinking.com.openapi.sdk.samples.OrderListDemo中的写法\n\n7、使用python调用接口时,为了防止大写False/True导致签名错误,Boolean字段统一用字符串'true'或’false‘;\n\n3. 频繁出现access_token过期\n\n```text\n{\n\t\"code\":\"2001005\",\n\t\"msg\":\" access token not match\"\n}\n```\n\n解决方法:检查自己本地是否存在别的应用一直在重复请求导致access_token频繁变换。\n\n4. ip被限制访问\n\n```text\n{\n        \"code\": \"3001002\",\n        \"msg\": \"ip not permit, please add ip to white list first.\",\n        \"data\": {\n                \"throwable\": \"ip not permit, please add ip to white list first.\",\n                \"throwTime\": \"2021-12-27 15:49:19\",\n                \"message\": null,\n                \"stackTrace\": null,\n                \"metadata\": {}\n        }\n}\n```\n\n原因:应用所在服务器的ip不在白名单中。\n\n解决方法:ip未加入白名单,确认发起ip地址后在【设置】>【业务配置】>【全局】>【开放接口】自行增加即可。\n\n5. 服务器返回400\n\n```text\n{\n    \"code\": 400,\n    \"message\": \"服务不存在\",\n    \"error_details\": [],\n    \"request_id\": \"903BFE57-E7B3-81C2-4E4A-29EDA32C3B59\",\n    \"response_time\": \"2021-12-27 16:21:14\",\n    \"data\": [],\n    \"total\": 0\n}\n```\n\n原因:请求url路径不正确。\n\n解决方法:检查url地址是否正确。\n\n6. 服务器返回405\n\n```text\nResponse error, status code: 405, body: <html>\n<head><title>405 Not Allowed</title></head>\n<body>\n<center><h1>405 Not Allowed</h1></center>\n<hr><center>nginx</center>\n</body>\n</html>\n```\n\n原因:请求url路径不正确。\n\n解决方法:检查url地址是否正确。\n\n7. 服务器返回500\n\n```text\n{\n    \"code\": \"500\",\n    \"msg\": \"404 NOT_FOUND\",\n    \"data\": {\n        \"throwable\": \"404 NOT_FOUND\",\n        \"throwTime\": \"2021-12-27 16:22:09\",\n        \"message\": null,\n        \"stackTrace\": null,\n        \"metadata\": {}\n    }\n}\n```\n\n原因:请求url路径不正确。\n\n解决方法:检查请求地址是否正确,注意 Domain与 API Path 的拼接中不要有多余的 ”/“【反斜杠】。\n\n8. 公共请求参数不完整\n\n```text\n{\n    \"code\": \"3001001\",\n    \"msg\": \"missing query param(access_token,sign,timestamp,app_key)\",\n    \"data\": {\n        \"throwable\": \"missing query param(access_token,sign,timestamp,app_key)\",\n        \"throwTime\": \"2024-07-11 14:58:44\",\n        \"message\": null,\n        \"stackTrace\": null,\n        \"metadata\": {}\n    }\n}\n```\n\n原因:公共请求参数不完整。\n\n解决方法:在 URL Query 中传入 app_key、timestamp、sign,并通过 Authorization: Bearer <access_token> 请求头传递 token。过渡期也兼容 Query token,该方式将于 2027 年 1 月 1 日正式下线,请参见接入指南提前迁移。\n\n如果请求头和 Query token 不一致,返回 3001022;请保持值一致或只通过请求头传递。Authorization 为空、格式错误或重复发送时返回 3001025;请只发送一个有效的 Bearer 请求头,不会回退使用 Query token。\n\n9. 参数不合法\n\n```text\n{\n    \"code\": \"102\",\n    \"msg\": \"参数不合法\",\n    \"data\": {\n        \"throwable\": \"参数不合法\",\n        \"throwTime\": \"2024-07-11 14:58:44\",\n        \"message\": null,\n        \"stackTrace\": null,\n        \"metadata\": {}\n    }\n}\n```\n\n原因:数组、List集合在生成sign过程中会将其数据类型转为string类型后传入body参数当中,而转义后的数据不符合接口文档传入参数类型的规范\n\n解决方法:在生成sign之后,添加一段代码将body参数中对应的值重新以本身数组或List集合类型进行覆盖即可\n\n10. 限流拦截\n\n```text\n{\n    \"code\":103,\n    \"message\":\"请求过于频繁,请稍后再试 [C0C1B855-48A2-6BB6-5636-5AC80042386C]\",\n    \"error_details\":[],\n    \"request_id\":\"4B750B70-2026-FE98-B88F-400B91D3F1E4\",\n    \"response_time\":\"2024-07-21 03:10:37\",\n    \"data\":[],\n    \"total\":0\n}\n```\n\n原因:请求速率过高导致被限流拦截\n\n解决办法:根据限流规则去设计发送请求的频率,防止被系统拦截\n\n11. appId被禁用\n\n```text\n{\n    \"code\": \"401\",\n    \"msg\": \"授权被禁用,请检查授权状态\",\n    \"data\": null\n}\n```\n\n解决办法:请求接口的appId被禁用了,请联系erp超级管理员在 设置-全局-开放接口 页面,为该appId解除禁用\n\n12. appId已经失效\n\n```text\n{\n    \"code\": \"403\",\n    \"msg\": \"授权失效,请更新授权有效期\",\n    \"data\": null\n}\n```\n\n解决办法:请求接口的appId过期,请联系erp超级管理员在 设置-全局-开放接口 页面,为该appId更新授权有效期\n\n13. appId没有接口权限\n\n```text\n{\n    \"msg\": \"授权失效,请更新授权有效期或检查权限\",\n    \"code\": \"403\",\n    \"data\": null\n}\n```\n\n解决办法:appId账号没有其请求接口的权限,请联系erp超级管理员在 设置-全局-开放接口 页面,为该appId授权接口"
}

接口请求参数

暂无参数说明

接口响应参数

暂无参数说明

领星ERP的接口:常见问题案例(/new/guides/qa/),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。