/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版本更新同步更新。