跳到主要内容

v1 API 获取表单视图数据列表

API 使用者，可以通过本接口，按指定视图的字段、筛选、排序配置获取指定表单的数据列表

功能免费版专业版/专业增强版企业基础版企业协作版企业高级版
获取表单视图数据列表✔️✔️✔️✔️✔️

认证方式​

V1 Bearer 认证方式

headers 设置​

需要在请求中设置如下 headers

  • Content-Type: application/json
  • Accept: application/json
  • Authorization: 放入上一步骤生成的 CODE

接口说明​

  • API 使用者可以获取自己创建或有访问权限的共享表单数据。
  • VIEW_TOKEN 可以从获取表单视图列表接口取得。
  • 返回的数据会应用视图的 filter 和 sort 规则。
  • 返回的数据字段会受视图 prefer_columns 控制；当视图没有设置 prefer_columns 时，返回表单可推送字段。
  • 数据过多时，接口会返回分页数据。每页 50 个。接口会返回下一页的标记。
  • 未开通自定义视图能力时，仍可读取系统预设视图的数据，但不能读取自定义视图的数据。

接口描述​

Request​

# 第一页
GET https://jinshuju.net/api/v1/forms/FORM_TOKEN/views/VIEW_TOKEN/entries

# 如果数据过多，请求后续的数据
GET https://jinshuju.net/api/v1/forms/FORM_TOKEN/views/VIEW_TOKEN/entries?next=51
参数名称是否必须类型说明
FORM_TOKEN是String表单 Token（URL 路径参数）
VIEW_TOKEN是String视图 Token（URL 路径参数）
next否Integer分页参数。原样传回上一页响应中的 next
include_labels否Boolean为 true 时，表单字段的值改为 {label, value} 形式

Response​

{
    "total": 828,
    "count": 50,
    "data": [
        {
            "serial_number": 1,
            "field_1": "张三",
            "field_2": "13000000000",
            "created_at": "2026-05-26T02:00:00.000Z",
            "updated_at": "2026-05-26T02:00:00.000Z"
        },
        {
            "serial_number": 2,
            "field_1": "李四",
            "field_2": "13000000001",
            "created_at": "2026-05-26T02:10:00.000Z",
            "updated_at": "2026-05-26T02:10:00.000Z"
        }
    ],
    "next": 51
}
参数名称是否必须类型说明
total是Integer符合视图筛选条件的数据总数
count是Integer本次请求返回的数据数量
data是Array(EntryData)数据数组
next是Integer / null分页参数。原样传回即可请求下一页数据；null 表示没有下一页

返回字段详细结构，请参考数据 Schema。

注意：数据中的日期时间，使用的是 UTC 时间（例如："2026-05-26T02:00:00.000Z"），接受者需要自行转换为自己所需要的时区（例如北京时间）。

状态码​

状态码说明
200获取成功
400参数不合法，或视图筛选条件含不支持的运算符
401未认证
402当前套餐不支持 V1 API，或当前账户不支持读取自定义视图
403无权限（如 OAuth scope 不足）
404表单或视图不存在，或无权访问

数据类型​

EntryData​

参数名称是否必须类型说明
token是String数据唯一标识
serial_number是Integer数据序号（标识符）
created_at否DateTime数据提交时间
updated_at否DateTime数据最后一次变更时间
creator_name否String本条数据的填写者（仅对系统内录入数据有效）
color_mark否String颜色标记
info_filling_duration否Number填写时长（秒）；Excel 导入、API 提交的数据为空
info_platform否String填写设备
info_os否String操作系统
info_browser否String浏览器
info_region否Object填写地区
info_region.country否String国家
info_region.province否String省份
info_region.city否String城市
info_remote_ip否String填写者 IP 地址
*否Any对应字段的值，键为字段 api_code

示例代码​

HTTP​

GET https://jinshuju.net/api/v1/forms/$FORM_TOKEN/views/$VIEW_TOKEN/entries

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

Python​

import requests

access_token = 'YOUR_ACCESS_TOKEN'
form_token = 'YOUR_FORM_TOKEN'
view_token = 'YOUR_VIEW_TOKEN'

response = requests.get(
    f'https://jinshuju.net/api/v1/forms/{form_token}/views/{view_token}/entries',
    headers={'Authorization': f'Bearer {access_token}'}
)

print(response.text)