跳到主要内容

获取账套用户列表

按账套代号获取账套下的有效用户列表，供用户登录时选择操作员代号​

基本信息​

信息值备注
接口名称获取账套用户列表免登录接口，无需 LoginId
请求状态GETRESTful 方式
接口路径http://localhost:23798/api/Company/GetUserList?compNo=K006向服务器地址发送 GET 请求
远程模式http://www.linkerplus.com/api/ext_erp/Company/GetUserList?compNo=K006远程模式向服务器地址发送 GET 请求，需要 ERP 注册号注册远程模式，并在 Headers 添加 sn 参数
支持日期2026-10-30自该日期起支持

请求参数​

Headers​

参数名称是否必须参数值备注
sn否MGR_REST_1001远程模式需添加 sn 参数，MGR_REST_ERP注册号；本地直连模式无需任何 Headers 参数

Query​

参数名称类型是否必须参数值备注其它信息
compNostring是K006账套代号长度不能超过4位，服务端自动转大写，与「获取账套列表」返回的 COMPNO 对应

返回数据​

参数名称类型参数值备注
Codenumber0业务状态码，0 表示成功
Messagestring获取账套用户列表成功。返回信息，成功或错误描述
Resultobject返回结果
Result.dataarray有效用户列表，仅返回有效期内的用户，按 USR 排序
Result.data[].USRstringADMIN操作员代号
Result.data[].NAMEstring系统管理员操作员名称

返回状态码​

状态码说明HTTP 状态
0成功HTTP 200
20001必要参数缺失（compNo 为空）HTTP 400
20003参数值非法（compNo 超过4位）HTTP 400
30001账套不存在HTTP 404
50004请求频率超限HTTP 429
50005数据库操作异常HTTP 500
50001系统内部异常HTTP 500

调用范例​

Request​

GET /api/Company/GetUserList?compNo=DEMO HTTP/1.1
Host: localhost:23798

Response​

成功示例（HTTP 200）​
{
    "Code": 0,                                          // 业务状态码，0 表示成功
    "Message": "获取账套用户列表成功。",                // 返回信息
    "Result": {                                         // 返回结果
        "data": [                                       // 有效用户列表，按 USR 排序
            {
                "USR": "ADMIN",                         // 操作员代号
                "NAME": "系统管理员"                    // 操作员名称
            },
            {
                "USR": "WMS01",                         // 操作员代号
                "NAME": "仓库管理员"                    // 操作员名称
            }
        ]
    }
}
失败示例（账套不存在，HTTP 404）​
{
    "Code": 30001,                                      // 业务状态码，30001 表示账套不存在
    "Message": "账套[DEMO]不存在。",                    // 返回信息
    "Result": {}                                        // 返回结果，失败时为空对象
}

备注​

  1. 本接口是登录接口的前序操作，免登录，不需要先获取LoginId。典型调用顺序：获取账套列表 → 获取账套用户列表 → 用户登录/账套验证 → 携带LoginId调用其它接口。返回的USR即「用户登录」接口授权凭证中账套代号_操作员代号的操作员代号。

  2. 服务端对同一 IP 限流，默认每分钟最多 30 次，超限返回 HTTP 429（状态码 50004）。

  3. 返回结果按账套缓存约 5 分钟，期间用户资料变更不会立即反映。

需要注意

先判断返回的 HttpStatusCode 是否等于200，如果是则表示调用成功，否则返回错误信息

免登录接口

本接口是登录接口的前序操作，不需要传入 LoginId，也不能在 Headers 里传 LoginId

返回格式

所有接口都以 JSON 格式返回