跳到主要内容

v1 API 获取企业账户成员列表

API 使用者，可以通过本接口，列出当前企业账户下的成员（id / 姓名 / 邮箱 / 手机号 / 角色 / 状态）。常用于：把表单协作给某位成员前，先列出团队拿到目标 user id。

功能免费版专业版/专业增强版企业基础版企业协作版企业高级版
获取企业账户成员列表✔️✔️✔️✔️✔️

认证方式​

V1 Bearer 认证方式

headers 设置​

需要在请求中设置如下 headers

  • Content-Type: application/json
  • Accept: application/json
  • Authorization: Bearer YOUR_ACCESS_TOKEN

接口说明​

  • 只列出当前凭证所属企业账户内的成员，无法跨账户查询。
  • 排序：先 status 升序（active 在前），再 created_at 倒序。
  • 默认返回前 50 条；通过 limit 调整，单次最多 100 条。

接口描述​

Request​

GET https://jinshuju.net/api/v1/billing_account/users
GET https://jinshuju.net/api/v1/billing_account/users?limit=20
参数名称是否必须类型说明
limit否Number返回条数上限，默认 50，最多 100

Response​

{
    "total": 3,
    "count": 3,
    "data": [
        {
            "id": "69ae2a7f126da845e46e1137",
            "name": "张三",
            "email": "zhangsan@example.com",
            "mobile": "13812345678",
            "role": "owner",
            "status": "active",
            "created_at": "2026-03-09T02:03:43Z"
        },
        {
            "id": "69b14ab1fa3d70c8a5e2c001",
            "name": "李四",
            "email": "lisi@example.com",
            "mobile": "13900000000",
            "role": "admin",
            "status": "active",
            "created_at": "2026-04-02T05:18:00Z"
        }
    ]
}
参数名称是否必须类型说明
total是Number当前账户内成员总数
count是Number本次返回的成员数量
data是Array成员信息数组
data[].id是String成员（用户）ID
data[].name是String成员显示名
data[].email是String邮箱
data[].mobile否String手机号（可能为空）
data[].role是String角色（owner / admin / worker / outworker）
data[].status是String状态（active / disabled）
data[].created_at是DateTime成员加入时间（UTC）

状态码​

状态码说明
200成功
401未认证
402当前套餐不支持 V1 API

示例代码​

HTTP​

GET https://jinshuju.net/api/v1/billing_account/users

Content-Type: application/json
Accept: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

Python​

import requests

access_token = 'YOUR_ACCESS_TOKEN'

response = requests.get(
    'https://jinshuju.net/api/v1/billing_account/users',
    headers={'Authorization': f'Bearer {access_token}'}
)

print(response.text)

Ruby​

require 'net/http'
require 'uri'

uri = URI.parse('https://jinshuju.net/api/v1/billing_account/users')
access_token = 'YOUR_ACCESS_TOKEN'

request = Net::HTTP::Get.new(uri)
request['Authorization'] = "Bearer #{access_token}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts(response.body)