示例说明

在 示例1 中，我们通过 API 获取到了“本周新品”视图下的所有商品数据（合计 4 条记录）。那可否指定返回第 2 条和第 4 条记录呢？

通过添加参数 recordIds 即可指定要返回的 Record ID 的数据，并且返回结果按照传入数组的顺序来排序（recSmw20itN9E , recgmPxp7gQTH）

样本数据

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

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

操作步骤

步骤一：展开第二条记录（相册视图下的第二个卡片），从浏览器地址栏的 url 中获得 recordId 。重复上述操作，获得第四条记录的 recordId 。

步骤二：调用 API「获取记录」，使用请求参数 recordIds 并带上第二条和第四条记录的 ID（recSmw20itN9E , recgmPxp7gQTH），调用方法见下文。

步骤三：维格表服务端接收到请求后，将会返回指定两条记录的数据。

API调用

通过添加参数 recordIds 即可返回指定的 Record ID 数据，返回结果顺序与传入数组元素的顺序保持一致（recSmw20itN9E , recgmPxp7gQTH）

参数： recordIds

参数类型：字符串数组（Array Of Strings）

recordIds 数组。如果附带此参数，则返回参数中指定的 records 数组。
返回结果按照传入数组的顺序来排序。
注 ①：如果 Request 中带有此参数，会忽略筛选、排序条件。

兼容如下几种格式规范（任选一种即可）：

格式1：recordIds=recSmw20itN9E,recgmPxp7gQTH

格式2：recordIds=recSmw20itN9E&recordIds=recgmPxp7gQTH

格式3：recordIds[]=recSmw20itN9E&recordIds[]=recgmPxp7gQTH

① cURL 示意：

curl 'https://api.vika.cn/fusion/v1/datasheets/dstdQxaqwGaoBbB8bK/records?recordIds=recSmw20itN9E,recgmPxp7gQTH' \
  -H 'Authorization: Bearer {_替换成你的API_Token_}'

② 调试工具示意：

返回结果：

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

{
    "code": 200,
    "success": true,
    "data": {
        "total": 2,
        "pageNum": 1,
        "pageSize": 2,
        "records": [
            {
                "recordId": "recSmw20itN9E",
                "createdAt": 1610103747000,
                "updatedAt": 1610103747000,
                "fields": {
                    "摘要": "6叶镀钛刀头/便携运动杯/3万转高速电机/可选配研磨杯配件",
                    "分类": "本周新品",
                    "原价": 199,
                    "促销价": 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"
                        }
                    ],
                    "主要卖点": [
                        "自动清洗",
                        "按键式"
                    ]
                }
            },
            {
                "recordId": "recgmPxp7gQTH",
                "createdAt": 1610103747000,
                "updatedAt": 1610103747000,
                "fields": {
                    "摘要": "一键真空保鲜 单手开盖 特有分享杯",
                    "分类": "本周新品",
                    "原价": 299,
                    "促销价": 239,
                    "入库时间": 1610103747460,
                    "标题": "无线真空便携榨汁杯",
                    "配图": [
                        {
                            "id": "atcIYoD9P9BbO",
                            "name": "7d7916be80a9e39d34cb3fc5c59e6d9d.png?w=800&h=800",
                            "size": 111041,
                            "mimeType": "image/png",
                            "token": "space/2020/05/26/1265118368272408578",
                            "width": 800,
                            "height": 800,
                            "url": "https://s1.vika.cn/space/2020/05/26/1265118368272408578"
                        }
                    ],
                    "主要卖点": [
                        "真空",
                        "按键式"
                    ]
                }
            }
        ]
    },
    "message": "SUCCESS"
}