跳到主要内容

获取账套列表

免登录获取全部账套的代号与名称列表，供登录前选择账套使用​

基本信息​

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

请求参数​

Headers​

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

本接口无需 Body 与 Query 参数。

返回数据​

参数名称类型参数值备注
Codenumber0业务状态码，0 表示成功
Messagestring获取账套列表成功。成功时返回成功提示，失败时返回错误描述
Resultobject返回结果对象
Result.dataarray账套列表，每个元素包含 COMPNO、NAME、NAME_ENG 三个字段
Result.data[].COMPNOstringDEMO账套代号
Result.data[].NAMEstring演示账套账套名称
Result.data[].NAME_ENGstringDemo账套英文名称

返回状态码​

状态码说明HTTP 状态码
0成功HTTP 200
50004请求频率超限HTTP 429
50005数据库操作异常HTTP 500
50001系统内部异常HTTP 500

调用范例​

Request​

GET /api/Company/GetCompList HTTP/1.1
Host: localhost:23798

Response​

成功示例（HTTP 200）​
{
    "Code": 0,                                        // 业务状态码，0 表示成功
    "Message": "获取账套列表成功。",                  // 成功提示信息
    "Result": {                                       // 返回结果对象
        "data": [                                     // 账套列表
            {
                "COMPNO": "DEMO",                     // 账套代号
                "NAME": "演示账套",                   // 账套名称
                "NAME_ENG": "Demo"                    // 账套英文名称
            },
            {
                "COMPNO": "K006",                     // 账套代号
                "NAME": "示例账套",                   // 账套名称
                "NAME_ENG": "Sample Account"          // 账套英文名称
            }
        ]
    }
}
失败示例（请求频率超限，HTTP 429）​
{
    "Code": 50004,                                    // 业务状态码，50004 表示请求频率超限
    "Message": "请求频率超限，请稍后再试。",          // 错误提示信息
    "Result": {}                                      // 失败时无返回数据
}

备注​

本接口是登录接口的前序操作（免登录），不需要先获取LoginId。典型调用顺序：获取账套列表 → 获取账套用户列表 → 用户登录/账套验证 → 携带LoginId调用其它接口。

服务端对同一 IP 限流，默认每分钟最多 30 次请求，超限返回 HTTP 429，稍后再试即可。

返回结果有约 5 分钟缓存，账套资料变更后不会立即反映，稍后重新调用即可获取最新数据。

需要注意

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

免登录接口

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

返回格式

所有接口都以 JSON 格式返回