跳到主要内容

v1 API 获取文件夹列表

API使用者，可以通过本接口，获取自己可管理的文件夹列表

功能免费版专业版/专业增强版企业基础版企业协作版企业高级版
获取文件夹列表✔️✔️✔️

认证方式​

V1 Basic 认证方式

headers 设置​

需要在请求中设置如下 headers

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

接口说明​

  • 个人版用户/企业子账号用户，只会返回当前用户具有 管理员角色 的文件夹。
  • 企业全局 API，返回企业 owner 可管理的文件夹。
  • 用返回的 token 可以用于创建表单、复制表单或移动表单。

接口描述​

Request​

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

Response​

{
    "total": 3,
    "count": 3,
    "data": [
        { "token": "xY9aB2", "name": "客户反馈", "created_at": "2026-04-01T10:23:11.000Z" },
        { "token": "pQ3kL7", "name": "内部调研", "created_at": "2026-03-28T08:15:02.000Z" },
        { "token": "m7NfZ1", "name": "活动报名", "created_at": "2026-03-20T14:02:55.000Z" }
    ]
}
参数名称是否必须类型说明
total是Number当前账号可管理的文件夹总数
count是Number本次请求返回的文件夹数量
data是Array文件夹信息数组
data[].token是String文件夹 token
data[].name是String文件夹名称
data[].created_at是DateTime文件夹创建时间

状态码​

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

示例代码​

HTTP​

GET https://jinshuju.net/api/v1/folders

Content-Type: application/json
Accept: application/json
Authorization: Basic BASE_64_ENCODED_CREDENTIALS

Python​

import requests

api_key = 'YOUR_API_KEY'
api_secret = 'YOUR_API_SECRET'

response = requests.get(
    'https://jinshuju.net/api/v1/folders',
    auth=(api_key, api_secret)
)

print(response.text)

Ruby​

require 'net/http'
require 'uri'

uri = URI.parse('https://jinshuju.net/api/v1/folders')
api_key = 'YOUR_API_KEY'
api_secret = 'YOUR_API_SECRET'

request = Net::HTTP::Get.new(uri)
request.basic_auth(api_key, api_secret)

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

puts(response.body)