메모 끝점

Reactor API에서 참고는 특정 리소스에 추가할 수 있는 텍스트 주석입니다. 메모는 본질적으로 각 리소스에 대한 주석입니다. 참고의 내용은 리소스 동작에 영향을 주지 않으며, 다음을 포함한 다양한 사용 사례에 사용할 수 있습니다.

• 배경 정보 제공
• 할 일 목록으로 사용
• 리소스 사용 조언 전달
• 다른 팀 구성원에게 지침 제공
• 기록 컨텍스트 기록

Reactor API의 /notes 종단점을 사용하면 이러한 메모를 프로그래밍 방식으로 관리할 수 있습니다.

참고는 다음 리소스를 적용할 수 있습니다.

• 데이터 요소
• 확장
• 라이브러리
• 속성
• 규칙 구성 요소
• 규칙

이 여섯 가지 유형들은 전체적으로 "주목할 만한" 자원이라고 알려져 있습니다. 주목할 만한 리소스가 삭제되면 관련 참고 사항도 삭제됩니다.

시작하기

이 안내서에 사용된 끝점은 Reactor API의 일부입니다. 계속하기 전에 API 인증 방법에 대한 중요한 정보가 필요하면 시작 안내서를 검토하십시오.

메모 목록 검색

해당 리소스에 대한 GET 요청 경로에 /notes을 추가하여 리소스에 대한 메모 목록을 검색할 수 있습니다.

API 형식

GET /{RESOURCE_TYPE}/{RESOURCE_ID}/notes

요청

다음 요청에는 라이브러리에 첨부된 참고가 나열됩니다.

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: {IMS_ORG}' \
  -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}

요청

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: {IMS_ORG}' \
  -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"
    }
  }
}

참고 만들기

해당 리소스에 대한 POST 요청 경로에 /notes을 추가하여 새 메모를 만들 수 있습니다.

API 형식

POST /{RESOURCE_TYPE}/{RESOURCE_ID}/notes

요청

다음 요청은 속성에 대한 새 메모를 만듭니다.

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: {IMS_ORG}' \
  -H 'Content-Type: application/json' \
  -d '{
        "data": {
          "type": "notes",
          "attributes": {
            "text": "this is a note on a property"
          }
        }
      }'

응답

성공적으로 응답하면 새로 만든 참고의 세부 정보가 반환됩니다.

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