POST /api/attr/batchGetBlockAttrs

批量获取块属性

需要认证

接口描述

一次性获取多个指定块的所有命名属性。

请求参数

参数名	类型	必选	描述
ids	string[]	是	要获取属性的块 ID 列表。

返回值

返回一个对象，键是块 ID，值是该块的属性键值对对象。

参数名	类型	描述
code	number	返回码，0表示成功
msg	string	返回信息
data	object	块 ID 到属性对象（{attrName: attrValue}）的映射。如果某个块不存在或没有属性，则对应的键值可能不存在或值为空对象 {}。

请求示例 (cURL)

返回示例

请求示例 (cURL)

curl -X POST \
  http://127.0.0.1:6806/api/attr/batchGetBlockAttrs \
  -H 'Authorization: Token YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "ids": ["20231027140000-abcdef1", "20231027140000-abcdef2"]
}'

返回示例

{
    "code": 0,
    "msg": "",
    "data": {
        "20231027140000-abcdef1": {
            "custom-attr1": "value1",
            "updated": "1678886400000"
        },
        "20231027140000-abcdef2": {
            "custom-attr2": "value2" 
        }
    }
}

注意：这是一个社区维护的文档，可能与官方最新版本存在差异。

如果您觉得本文档有帮助，可以考虑赞助支持：爱发电

在线测试

返回首页返回 Attr API 上一个接口: 获取块属性下一个接口: 通过引用文本获取块定义 ID