附註端點

在Reactor API中，附註是可新增至特定資源的文字註釋。 附注本質上是對其各自資源的評論。 附註的內容對資源行為沒有影響，可用於各種使用案例，包括：

  • 提供背景資訊
  • 作為待辦事項清單使用
  • 傳遞資源使用建議
  • 向其他團隊成員提供指示
  • 記錄歷史內容

此 /notes Reactor API中的端點可讓您以程式設計方式管理這些備註。

附註可套用下列資源：

這六種型別統稱為「重要」資源。 刪除重要資源時，也會刪除其相關附註。

注意

對於可以有多個修訂版本的資源，必須在目前（標題）修訂版本上建立任何附註。 它們不能附加到其他修訂版本。

不過，仍可從修訂版本讀取附註。 在這種情況下，API只會傳回建立修訂版本之前存在的附註。 它們提供與剪下修訂版本時相同的註釋快照。 相較之下，從目前（標題）修訂版本讀取附註會傳回其所有附註。

快速入門

本指南中使用的端點是 Reactor API. 在繼續之前，請檢閱 快速入門手冊 有關如何向API驗證的重要資訊。

擷取附註清單

您可以藉由附加來擷取資源的附註清單 /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
    }
  }
}

查詢附註

您可以在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"
    }
  }
}

建立附註

警告

建立新註記之前，請記住，註記不可編輯，刪除註記的唯一方式是刪除其對應的資源。

您可以藉由附加來建立新的附註 /notes 到相關資源的POST請求路徑。

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"
    }
  }
}

本頁內容