비헤이비어 끝점

XDM(경험 데이터 모델)에서 비헤이비어는 스키마에서 설명하는 데이터의 특성을 정의합니다. 각 XDM 클래스는 특정 비헤이비어를 참조해야 하며, 이 클래스를 사용하는 모든 스키마는 상속됩니다. Platform(플랫폼)에서 거의 모든 사용 사례에는 두 가지 사용 가능한 비헤이비어가 있습니다.

• Record:제목 속성에 대한 정보를 제공합니다. 대상은 조직 또는 개인일 수 있습니다.
• Time-series:작업 수행 시 기록 제목에 의해 직접 또는 간접적으로 작업이 수행될 때 시스템의 스냅샷을 제공합니다.

Schema Registry API의 /behaviors 끝점을 사용하면 global 컨테이너에서 사용 가능한 동작을 볼 수 있습니다.

시작하기

이 안내서에 사용된 끝점은 Schema Registry API의 일부입니다. 계속하기 전에 시작하기 안내서에서 관련 설명서에 대한 링크, 이 문서에서 샘플 API 호출 읽기 안내서, Experience Platform API를 성공적으로 호출하기 위해 필요한 필수 헤더에 대한 중요 정보를 검토하십시오.

비헤이비어 목록 검색

/behaviors 끝점에 GET 요청을 하여 사용 가능한 모든 비헤이비어 목록을 검색할 수 있습니다.

API 형식

GET /global/behaviors

요청

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/global/behaviors \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Accept: application/vnd.adobe.xed-id+json'

응답

{
    "results": [
        {
            "$id": "https://ns.adobe.com/xdm/data/record",
            "meta:altId": "_xdm.data.record",
            "version": "1.16.4",
            "title": "Record Schema"
        },
        {
            "$id": "https://ns.adobe.com/xdm/data/adhoc",
            "meta:altId": "_xdm.data.adhoc",
            "version": "1.16.4",
            "title": "Ad Hoc Schema"
        },
        {
            "$id": "https://ns.adobe.com/xdm/data/time-series",
            "meta:altId": "_xdm.data.time-series",
            "version": "1.16.4",
            "title": "Time-series Schema"
        }
    ],
    "_page": {
        "orderby": "updated",
        "next": null,
        "count": 3
    },
    "_links": {
        "next": null
    }
}

비헤이비어 조회

/behaviors 종단점에 대한 GET 요청 경로에 해당 ID를 제공하여 특정 동작을 찾을 수 있습니다.

API 형식

GET /global/behaviors/{BEHAVIOR_ID}

요청

다음 요청은 요청 경로에 meta:altId을 제공하여 레코드 동작의 세부 사항을 검색합니다.

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/global/behaviors/_xdm.data.record \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Accept: application/vnd.adobe.xed+json;version=1'

응답

성공적인 응답은 해당 버전, 설명 및 비헤이비어가 비헤이비어를 사용하는 클래스에 제공하는 특성을 비롯하여 비헤이비어의 세부 사항을 반환합니다.

{
    "$id": "https://ns.adobe.com/xdm/data/record",
    "meta:altId": "_xdm.data.record",
    "meta:resourceType": "behaviors",
    "version": "1.16.4",
    "title": "Record Schema",
    "type": "object",
    "description": "Used to indicate the behavior of record data semantic when composed into data schemas.",
    "definitions": {
        "record": {
            "properties": {
                "_id": {
                    "title": "Identifier",
                    "type": "string",
                    "format": "uri-reference",
                    "description": "A unique identifier for the record.",
                    "meta:xdmType": "string",
                    "meta:xdmField": "@id"
                }
            }
        }
    },
    "allOf": [
        {
            "$ref": "#/definitions/record",
            "type": "object",
            "meta:xdmType": "object"
        },
        {
            "$ref": "https://ns.adobe.com/xdm/common/extensible#/definitions/@context",
            "type": "object",
            "meta:xdmType": "object"
        }
    ],
    "meta:extensible": true,
    "meta:abstract": true,
    "meta:xdmType": "object",
    "meta:status": "stable",
    "$schema": "http://json-schema.org/draft-06/schema#",
    "meta:registryMetadata": {
        "repo:createdDate": 1606266789446,
        "repo:lastModifiedDate": 1606266789446,
        "eTag": "2cc114a54949a9668fe2ad046ccece59192e1bfa28f14e5ac7c893acb7820ba2",
        "meta:globalLibVersion": "1.16.4"
    }
}

다음 단계

이 안내서에서는 Schema Registry API에서 /behaviors 끝점의 사용에 대해 다룹니다. API를 사용하여 클래스에 비헤이비어를 할당하는 방법을 알아보려면 클래스 끝점 안내서를 참조하십시오.