跳到主要内容

常见问答 FAQ

API 相关问题​

我想监听维格表中的数据改变，该怎么做？​

目前暂不支持 webhook，你可以轮询查询数据，检查数据是否有变更。敬请期待后续的自动化功能。

获取记录接口中的 filterByFormula 查询条件有更多的用例吗？​

需求场景公式完整查询
精确搜索符合条件的记录搜索「标题」这列中值等于「标题1」的记录{标题}="标题1"https://vika.cn/fusion/v1/datasheets/{datasheetId}/records?filterByFormula={标题}="标题1"'（{标题}="标题1" 需要先使用 encodeURIComponent() 函数进行转码）
模糊搜索符合条件的记录搜索「标题」这列中值包含「标题1」的记录find("标题1", {标题}) > 0https://vika.cn/fusion/v1/datasheets/{datasheetId}/records?filterByFormula=find("标题1", {标题}) > 0'（find("标题1", {标题}) > 0 需要先使用 encodeURIComponent() 函数进行转码）

在通讯录相关的 API 中，什么是 unitId？​

如果我们把一个空间站看作一家公司，那么小组就可以看作是公司内部的部门。 因此，您可以在空间站内创建多个小组，成员可以归属于多个小组。

一个空间站的通讯录由若干小组和成员组成（了解小组和成员）

  • 每个小组可以分配多个成员
  • 每个成员也可以属于多个小组

而角色不属于通讯录的组成部分，每个角色可以关联多个成员或小组。（了解角色）

对于每一个成员、小组、角色，都有对应唯一 ID，也就是 unitId。

你可以使用这个 unitId 去获取、更新、删除对应的成员、小组、角色，详细可见对应的 API 使用文档。

SDK 相关问题​

目前官方提供 SDK 吗？​

官方在 GitHub 上提供了 Javascript SDK 和 Python SDK，能让你轻松使用 Javascript 和 Python 语言调用维格表 API，实现数据的增删改查。

如何使用 SDK？​

  1. 安装和初始化 SDK
  2. 使用 SDK 调用相应 API 接口（详见各个接口的指南文档，如获取记录）

如何在微信小程序中使用 SDK?​

可以用，但是暂时不支持上传附件，参考在微信小程序中使用 Javascript SDK。

如何使用 Pandas 库查看和分析 Python SDK 返回的记录集？​

records = datasheet.records.all() 返回的结果是记录集，记录集中的每条记录是一个对象而不是 JSON 格式，因此无法使用 pandas.DataFrame(records) 直接展示结果。

你可以遍历每条记录分别打印出数据：

records = datasheet.records.all()
for record in records:
    print(record.json())

或者将记录集的每条记录转为 JSON 格式，便可以继续使用 Pandas 了：

records = datasheet.records.all()
json_records = [record.json() for record in records]
pandas.DataFrame(json_records)