비헤이비어 끝점

XDM(Experience Data Model)에서 동작은 스키마가 설명하는 데이터의 특성을 정의합니다. 각 XDM 클래스는 특정 동작을 참조해야 하며, 이 경우 해당 클래스를 사용하는 모든 스키마는 이 동작을 상속합니다. 플랫폼의 거의 모든 사용 사례에는 두 가지 동작이 있습니다.

• 기록: 제목의 속성에 대한 정보를 제공합니다. 주제는 조직 또는 개인일 수 있습니다.
• 시계열: 레코드 주체가 직접 또는 간접적으로 작업을 수행한 시간에 시스템의 스냅샷을 제공합니다.

다음 /behaviors 의 엔드포인트 Schema Registry API를 사용하면 의 사용 가능한 동작을 볼 수 있습니다. global 컨테이너.

시작하기

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

비헤이비어 목록 검색

에 GET 요청을 하여 사용 가능한 모든 동작 목록을 검색할 수 있습니다. /behaviors 엔드포인트.

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

동작 조회

에 대한 GET 요청 경로에 해당 ID를 제공하여 특정 동작을 조회할 수 있습니다. /behaviors 엔드포인트.

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

다음 단계

이 안내서에서는 의 사용을 다룹니다. /behaviors 의 엔드포인트 Schema Registry API. API를 사용하여 클래스에 동작을 할당하는 방법을 알아보려면 다음을 참조하십시오. 클래스 끝점 안내서.

Business.Adobe.com 리소스