템플릿화된 고객 필드의 유효성 검사

개요 overview

/authoring/testing/template/render 끝점은 대상 구성에 정의된 템플릿화된 고객 데이터 필드의 모양을 시각화하는 데 도움이 됩니다.

끝점은 고객 데이터 필드에 대한 무작위 값을 생성하고 응답에서 반환합니다. 버킷 이름 또는 폴더 경로와 같은 고객 데이터 필드의 의미 체계 구조를 확인하는 데 도움이 됩니다.

시작하기 getting-started

계속하기 전에 시작 안내서에서 필요한 대상 작성 권한 및 필수 헤더를 얻는 방법을 포함하여 API를 성공적으로 호출하기 위해 알아야 하는 중요한 정보를 검토하십시오.

전제 조건 prerequisites

/template/render 끝점을 사용하기 전에 다음 조건을 충족하는지 확인하십시오.

템플릿화된 고객 필드 렌더링 render-customer-fields

API 형식

POST /authoring/testing/template/render/destination

이 API 끝점의 동작을 설명하기 위해 다음 고객 데이터 필드 구성이 있는 파일 기반 대상을 생각해 보겠습니다.

"fileBasedS3Destination":{
   "bucket":{
      "templatingStrategy":"PEBBLE_V1",
      "value":"{{customerData.bucket}}"
   },
   "path":{
      "templatingStrategy":"PEBBLE_V1",
      "value":"{{customerData.path}}"
   }
}

요청

아래 요청은 /authoring/testing/template/render 끝점을 호출하며, 이 끝점은 위에 언급된 두 고객 데이터 필드에 대해 임의로 생성된 값이 있는 응답을 반환합니다.

curl -X POST 'https://platform.adobe.io/data/core/activation/authoring/testing/template/render/destination' \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
 {
    "destinationId": "{DESTINATION_CONFIGURATION_ID}",
    "templates": {
        "bucket": "{{customerData.bucket}}",
        "path": "{{customerData.bucket}}/{{customerData.path}}"
    }
}'

응답

성공한 응답은 HTTP 200 OK 상태를 반환하며 본문에는 템플릿화된 필드에 대해 임의로 생성된 값이 포함됩니다.

이 응답은 버킷 이름 또는 폴더 경로와 같은 고객 데이터 필드의 올바른 구조를 확인하는 데 도움이 됩니다.

{
    "results": {
        "bucket": "hfWpE-bucket",
        "path": "hfWpE-bucket/ceC"
    }
}

API 오류 처리 api-error-handling

Destination SDK API 엔드포인트는 일반적인 Experience Platform API 오류 메시지 원칙을 따릅니다. 플랫폼 문제 해결 안내서에서 API 상태 코드 및 요청 헤더 오류를 참조하십시오.

다음 단계 next-steps

이 문서를 읽고 나면 이제 대상 서버에 정의된 고객 데이터 필드 구성을 확인하는 방법을 알 수 있습니다.