Lingxing
切换旧版

主体列表查询

POST/basicOpen/stockSubject/list

查询当前授权公司下的备货主体完整列表,支持平台、团队两类主体,可按主体类型、名称和启用状态筛选。本接口不分页。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/stockSubject/listHTTPSPOST1

请求参数

subjectTypestring
主体类型,不区分大小写,建议使用大写值:
PLATFORM:平台主体
TEAM:团队主体
不传、null、空字符串或纯空白字符串查询全部类型;不支持的非空类型返回空列表;类型值前后不要附带空格
keywordstring
按主体名称模糊匹配,不匹配备注;不传、null、空字符串或纯空白字符串不按名称筛选;非空关键词不会自动去除首尾空格

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/stockSubject/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "subjectType": "PLATFORM",
    "keyword": "跨境"
}'

返回结果

Json Array

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-10-12 12:00:00
dataarray<object>必填
主体列表,无匹配数据时为[]
隐藏子属性
companyIdstring必填
公司ID,64位整数以十进制字符串返回
示例 100001
subjectTypestring必填
主体类型:
PLATFORM:平台主体
TEAM:团队主体
示例 PLATFORM
subjectIdstring必填
主体ID,64位整数以十进制字符串返回;不是平台编码
示例 2031234567890123456
subjectNamestring必填
主体名称
示例 跨境平台主体
remarkstring必填
备注,可为null
示例 平台备货业务
statusinteger必填
状态:
1:启用
0:停用
示例 1
gmtCreatestring必填
创建时间,yyyy-MM-dd HH:mm:ss;未记录时为null
示例 2026-10-09 09:00:00
gmtModifiedstring必填
修改时间,yyyy-MM-dd HH:mm:ss;未记录时为null
示例 2026-10-09 10:00:00
totalinteger必填
统一响应封装字段,固定为0,本接口不提供分页总数
示例 0

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-10-12 12:00:00",
    "data": [
        {
            "companyId": "100001",
            "subjectType": "PLATFORM",
            "subjectId": "2031234567890123456",
            "subjectName": "跨境平台主体",
            "remark": "平台备货业务",
            "status": 1,
            "gmtCreate": "2026-10-09 09:00:00",
            "gmtModified": "2026-10-09 10:00:00"
        }
    ],
    "total": 0
}