Qeasy Cloud
Get Started

领星ERP 常见问题案例 API

Platform
领星ERP
Type
DOC
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
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 为参数名参与签...
Updated At
2026-11-21

常见问题案例

DOC/new/guides/qa/
Factory
{
  "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授权接口"
}

Request Parameters

No parameter reference available

Response Parameters

No parameter reference available

The 常见问题案例 API (/new/guides/qa/) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.