示例说明

试想一下，「样本数据2 - 商品列表」 里有“本周新品”，“热卖爆品”，“厨电新品”等分类标签，如何通过 API 获取到 “本周新品” 的所有商品数据呢？

最简单的办法是利用维格表的「视图」能力，在调用 API 「获取记录」的时候添加 viewId 参数，指定目标视图的 ID，这样就可以复用视图里的筛选条件，从而获取到“本周新品” 。

样本数据

API 文档里所使用的示例数据，皆可通过此分享链接获得：《API 教程示例数据》，建议另存到自己的空间站，然后跟着例子一步一步学习，事半功倍哦！

本示例将使用分享链接里的「样本数据2 - 商品列表」展开讲解。

操作步骤

步骤一：新建一个视图，并且设置筛选条件当 “分类” 等于 “本周新品”。

步骤二：在 浏览器地址栏 url 中获取当前视图的 ID，然后调用 API 时附带上。

步骤三：维格表服务端接收到请求后，将会按照指定视图的筛选条件进行记录过滤，最后返回匹配 “本周新品” 分类的所有商品记录。

API 调用

假设维格表 ID 为 dstdQxaqwGaoBbB8bK ，视图 ID 为 viw8oo0Pg1j8h ，则 Request 的结构如下：

① cURL 示意：

curl "https://api.vika.cn/fusion/v1/datasheets/dstdQxaqwGaoBbB8bK/records?viewId=viw8oo0Pg1j8h&fieldKey=name" \
  -H "Authorization: Bearer {_替换成你的API_Token_}"

② 调试工具示意：

返回结果：

正常情况下，维格表服务端会返回下述 JSON 数据包

{
    "code": 200,
    "success": true,
    "data": {
        "total": 4,
        "pageNum": 1,
        "pageSize": 4,
        "records": [
            {
                "recordId": "reckXvJFY7DvZ",
                "createdAt": 1610103747000,
                "updatedAt": 1610103747000,
                "fields": {
                    "分类": "本周新品",
                    "原价": 99,
                    "入库时间": 1610103747460,
                    "标题": "便携榨汁机 白色",
                    "配图": [
                        {
                            "id": "atcuZHjwSyXSc",
                            "name": "0ae6a9ed90d6154813fd28ab1da32bc6.png?w=800&h=800",
                            "size": 108704,
                            "mimeType": "image/png",
                            "token": "space/2020/05/26/1265120006453497857",
                            "width": 800,
                            "height": 800,
                            "url": "https://s1.vika.cn/space/2020/05/26/1265120006453497857"
                        }
                    ],
                    "主要卖点": [
                        "机械式",
                        "榨汁"
                    ]
                }
            },
            {
                "recordId": "recSmw20itN9E",
                "createdAt": 1610103747000,
                "updatedAt": 1610103747000,
                "fields": {
                    "分类": "本周新品",
                    "原价": 199,
                    "入库时间": 1610103747460,
                    "标题": "搅拌料理机Pro",
                    "配图": [
                        {
                            "id": "atcAfgBCFQKwm",
                            "name": "7e25caa055523256122487ae338fa403.png?w=800&h=800",
                            "size": 110911,
                            "mimeType": "image/png",
                            "token": "space/2020/05/26/1265118339130384386",
                            "width": 800,
                            "height": 800,
                            "url": "https://s1.vika.cn/space/2020/05/26/1265118339130384386"
                        }
                    ],
                    "主要卖点": [
                        "自动清洗",
                        "按键式"
                    ]
                }
            }
            // ...more
        ]
    },
    "message": "SUCCESS"
}