注释端点

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

在Reactor API中，注释是可以添加到特定资源的文本批注。注释本质上是对其各自资源的评论。注释的内容对资源行为没有影响，可用于各种用例，包括：

提供背景信息
用作待办事项列表
传递资源使用建议
向其他团队成员提供说明
记录历史上下文

Reactor API中的/notes端点允许您以编程方式管理这些注释。

注释可应用以下资源：

这六种类型统称为“重要”资源。删除某个值得注意的资源时，也会删除其关联的注释。

NOTE

对于可以具有多个修订版本的资源，必须在当前（标题）修订版本上创建任何注释。它们不能附加到其他修订版。

但是，仍可从修订版本中读取注释。在这种情况下，API仅返回创建修订之前存在的注释。它们提供了修改时注释的快照。相反，从当前（标题）修订版阅读注释将返回其所有注释。

快速入门

本指南中使用的端点是Reactor API的一部分。在继续之前，请查看快速入门指南，以了解有关如何对API进行身份验证的重要信息。

检索注释列表 list

您可以将/notes附加到相关资源的GET请求路径中，以检索该资源的注释列表。

API格式

GET /{RESOURCE_TYPE}/{RESOURCE_ID}/notes

参数

描述

RESOURCE_TYPE

您正在为其获取注释的资源类型。必须为以下值之一：

data_elements
extensions
libraries
properties
rule_components
rules

RESOURCE_ID

要列出其笔记的特定资源的id。

请求

以下请求列出了附加到库的注释。

curl -X GET \
  https://reactor.adobe.io/libraries/LBcffea1a38c52408cae2398868625a12d/notes \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1'

响应

成功的响应将返回附加到指定资源的注释列表。

{
  "data": [
    {
      "id": "NTa40de8d76bfd4e40835830900ce83b7b",
      "type": "notes",
      "attributes": {
        "author_display_name": "John Smith",
        "author_email": "jsmith@example.com",
        "created_at": "2020-12-14T17:51:00.411Z",
        "text": "this is a note on a library"
      },
      "relationships": {
        "resource": {
          "links": {
            "related": "https://reactor.adobe.io/libraries/LBcffea1a38c52408cae2398868625a12d"
          },
          "data": {
            "id": "LBcffea1a38c52408cae2398868625a12d",
            "type": "libraries"
          }
        }
      },
      "links": {
        "resource": "https://reactor.adobe.io/libraries/LBcffea1a38c52408cae2398868625a12d",
        "self": "https://reactor.adobe.io/notes/NTa40de8d76bfd4e40835830900ce83b7b"
      }
    }
  ],
  "meta": {
    "pagination": {
      "current_page": 1,
      "next_page": null,
      "prev_page": null,
      "total_pages": 1,
      "total_count": 1
    }
  }
}

查找注释 lookup

您可以通过在GET请求的路径中提供注释的ID来查找注释。

API格式

GET /notes/{NOTE_ID}

参数

描述

NOTE_ID

要查找的注释的id。

请求

curl -X GET \
  https://reactor.adobe.io/notes/NT550b7a17ab304d49ba289a2978d673e5 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1'

响应

成功响应将返回注释的详细信息。

{
  "data": {
    "id": "NT550b7a17ab304d49ba289a2978d673e5",
    "type": "notes",
    "attributes": {
      "author_display_name": "John Smith",
      "author_email": "jsmith@example.com",
      "created_at": "2020-12-14T17:51:10.316Z",
      "text": "this is a note on a property"
    },
    "relationships": {
      "resource": {
        "links": {
          "related": "https://reactor.adobe.io/properties/PR4537ac6f1f204ffd864ec47c4b27c2e8"
        },
        "data": {
          "id": "PR4537ac6f1f204ffd864ec47c4b27c2e8",
          "type": "properties"
        }
      }
    },
    "links": {
      "resource": "https://reactor.adobe.io/properties/PR4537ac6f1f204ffd864ec47c4b27c2e8",
      "self": "https://reactor.adobe.io/notes/NT550b7a17ab304d49ba289a2978d673e5"
    }
  }
}

创建注释 create

WARNING

创建新注释之前，请记住，注释不可编辑，删除它们的唯一方法是删除其相应的资源。

您可以通过在相关资源的POST请求路径中附加/notes来创建新注释。

API格式

POST /{RESOURCE_TYPE}/{RESOURCE_ID}/notes

参数

描述

RESOURCE_TYPE

正在为其创建注释的资源类型。必须为以下值之一：

data_elements
extensions
libraries
properties
rule_components
rules

RESOURCE_ID

要为其创建注释的特定资源的id。

请求

以下请求为属性创建新的注释。

curl -X POST \
  https://reactor.adobe.io/properties/PRb25a704c0b7c4562835ccdf96d3afd31/notes \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Content-Type: application/json' \
  -d '{
        "data": {
          "type": "notes",
          "attributes": {
            "text": "this is a note on a property"
          }
        }
      }'

属性

描述

type

（必需） 正在更新的资源类型。对于此终结点，值必须为notes。

attributes.text

（必需） 包含注释的文本。每个注释最多可包含512个Unicode字符。

响应

成功的响应将返回新创建注释的详细信息。

{
  "data": {
    "id": "NT550b7a17ab304d49ba289a2978d673e5",
    "type": "notes",
    "attributes": {
      "author_display_name": "John Smith",
      "author_email": "jsmith@example.com",
      "created_at": "2020-12-14T17:51:10.316Z",
      "text": "This is a note on a property"
    },
    "relationships": {
      "resource": {
        "links": {
          "related": "https://reactor.adobe.io/properties/PR4537ac6f1f204ffd864ec47c4b27c2e8"
        },
        "data": {
          "id": "PR4537ac6f1f204ffd864ec47c4b27c2e8",
          "type": "properties"
        }
      }
    },
    "links": {
      "resource": "https://reactor.adobe.io/properties/PR4537ac6f1f204ffd864ec47c4b27c2e8",
      "self": "https://reactor.adobe.io/notes/NT550b7a17ab304d49ba289a2978d673e5"
    }
  }
}

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743