创建目标服务器是使用Destination SDK创建自己的目标的第一步。 目标服务器包括 服务器 和 模板 规格, 消息格式,以及 文件格式 选项(适用于基于文件的目标)。
本页举例说明了可用于创建自己的目标服务器的API请求和有效负载,使用 /authoring/destination-servers
API端点。
有关可通过此端点配置的功能的详细说明,请阅读以下文章:
Destination SDK支持的所有参数名称和值包括 区分大小写. 为避免区分大小写错误,请完全按照文档中所示使用参数名称和值。
在继续之前,请查看 快速入门指南 要成功调用API需要了解的重要信息,包括如何获取所需的目标创作权限和所需的标头。
您可以通过以下方式创建新的目标服务器配置 POST
请求 /authoring/destination-servers
端点。
API端点: platform.adobe.io/data/core/activation/authoring/destination-servers
API格式
POST /authoring/destination-servers
根据您创建的目标类型,您需要配置一个稍有不同的目标服务器类型。 请参阅以下选项卡中有关Destination SDK支持的每种目标类型的目标服务器示例。
以下负载示例包含每种目标服务器类型支持的所有参数。 您无需在请求中包含所有参数。 可根据您的需求自定义有效负载。
选择下面的每个选项卡以查看相应的API请求。
创建实时(流)目标服务器
在配置基于实时(流)API的集成时,您需要创建类似于以下所示的实时(流)目标服务器。
curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"name":"Moviestar destination server",
"destinationServerType":"URL_BASED",
"urlBasedDestination":{
"url":{
"templatingStrategy":"PEBBLE_V1",
"value":"https://api.moviestar.com/data/{{customerData.region}}/items"
}
},
"httpTemplate":{
"httpMethod":"POST",
"requestBody":{
"templatingStrategy":"PEBBLE_V1",
"value":"{ \"attributes\": [ {% for ns in [\"external_id\", \"yourdestination_id\"] %} {% if input.profile.identityMap[ns] is not empty and first_namespace_encountered %} , {% endif %} {% set first_namespace_encountered = true %} {% for identity in input.profile.identityMap[ns]%} { \"{{ ns }}\": \"{{ identity.id }}\" {% if input.profile.segmentMembership.ups is not empty %} , \"AEPSegments\": { \"add\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"realized\" or segment.value.status == \"existing\" %} {% if added_segment_found %} , {% endif %} {% set added_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ], \"remove\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"exited\" %} {% if removed_segment_found %} , {% endif %} {% set removed_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ] } {% set removed_segment_found = false %} {% set added_segment_found = false %} {% endif %} {% if input.profile.attributes is not empty %} , {% endif %} {% for attribute in input.profile.attributes %} \"{{ attribute.key }}\": {% if attribute.value is empty %} null {% else %} \"{{ attribute.value.value }}\" {% endif %} {% if not loop.last%} , {% endif %} {% endfor %} } {% if not loop.last %} , {% endif %} {% endfor %} {% endfor %} ] }"
},
"contentType":"application/json"
}
}
参数 | 类型 | 描述 |
---|---|---|
name |
字符串 | 必需。 表示服务器的友好名称,仅对Adobe可见。 合作伙伴或客户看不到此名称。 示例 Moviestar destination server . |
destinationServerType |
字符串 | 必需。 设置为 URL_BASED 适用于实时(流)目标。 |
urlBasedDestination.url.templatingStrategy |
字符串 | 必需.
|
urlBasedDestination.url.value |
字符串 | 必需。 填写Experience Platform应连接到的API端点的地址。 |
httpTemplate.httpMethod |
字符串 | 必需。 Adobe将在对服务器的调用中使用的方法。 选项包括 GET , PUT , POST , DELETE , PATCH . |
httpTemplate.requestBody.templatingStrategy |
字符串 | 必需。使用 PEBBLE_V1 。 |
httpTemplate.requestBody.value |
字符串 | 必需。 此字符串是一个字符转义版本,用于将Platform客户的数据转换为您的服务期望的格式。
|
httpTemplate.contentType |
字符串 | 必需。 您的服务器接受的内容类型。 此值很有可能 application/json . |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。
创建Amazon S3目标服务器
您需要创建 Amazon S3 目标服务器,类似于配置基于文件的服务器时所显示的服务器 Amazon S3 目标。
curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"name": "S3 destination",
"destinationServerType": "FILE_BASED_S3",
"fileBasedS3Destination": {
"bucket": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.bucket}}"
},
"path": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.path}}"
}
},
"fileConfigurations": {
"compression": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.compression}}"
},
"fileType": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.fileType}}"
},
"csvOptions": {
"quote": {
"templatingStrategy": "NONE",
"value": "\""
},
"quoteAll": {
"templatingStrategy": "NONE",
"value": "false"
},
"escape": {
"templatingStrategy": "NONE",
"value": "\\"
},
"escapeQuotes": {
"templatingStrategy": "NONE",
"value": "true"
},
"header": {
"templatingStrategy": "NONE",
"value": "true"
},
"ignoreLeadingWhiteSpace": {
"templatingStrategy": "NONE",
"value": "true"
},
"ignoreTrailingWhiteSpace": {
"templatingStrategy": "NONE",
"value": "true"
},
"nullValue": {
"templatingStrategy": "NONE",
"value": ""
},
"dateFormat": {
"templatingStrategy": "NONE",
"value": "yyyy-MM-dd"
},
"timestampFormat": {
"templatingStrategy": "NONE",
"value": "yyyy-MM-dd'T':mm:ss[.SSS][XXX]"
},
"charToEscapeQuoteEscaping": {
"templatingStrategy": "NONE",
"value": "\\"
},
"emptyValue": {
"templatingStrategy": "NONE",
"value": ""
}
}
}
}
参数 | 类型 | 描述 |
---|---|---|
name |
字符串 | 目标连接的名称。 |
destinationServerType |
字符串 | 根据目标平台设置此值。 对象 Amazon S3,将其设置为 FILE_BASED_S3 . |
fileBasedS3Destination.bucket.templatingStrategy |
字符串 | 必需。使用 PEBBLE_V1 。 |
fileBasedS3Destination.bucket.value |
字符串 | 的名称 Amazon S3 要由此目标使用的存储段。 |
fileBasedS3Destination.path.templatingStrategy |
字符串 | 必需。使用 PEBBLE_V1 。 |
fileBasedS3Destination.path.value |
字符串 | 将托管导出文件的目标文件夹的路径。 |
fileConfigurations |
不适用 | 参见 文件格式配置 有关如何配置这些设置的详细信息。 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。
创建 SFTP 目标服务器
您需要创建 SFTP 目标服务器,类似于配置基于文件的服务器时所显示的服务器 SFTP 目标。
curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"name":"File-based SFTP destination server",
"destinationServerType":"FILE_BASED_SFTP",
"fileBasedSftpDestination":{
"rootDirectory":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.rootDirectory}}"
},
"port": 22,
"encryptionMode" : "PGP"
},
"fileConfigurations": {
"compression": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.compression}}"
},
"fileType": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.fileType}}"
},
"csvOptions": {
"quote": {
"templatingStrategy": "NONE",
"value": "\""
},
"quoteAll": {
"templatingStrategy": "NONE",
"value": "false"
},
"escape": {
"templatingStrategy": "NONE",
"value": "\\"
},
"escapeQuotes": {
"templatingStrategy": "NONE",
"value": "true"
},
"header": {
"templatingStrategy": "NONE",
"value": "true"
},
"ignoreLeadingWhiteSpace": {
"templatingStrategy": "NONE",
"value": "true"
},
"ignoreTrailingWhiteSpace": {
"templatingStrategy": "NONE",
"value": "true"
},
"nullValue": {
"templatingStrategy": "NONE",
"value": ""
},
"dateFormat": {
"templatingStrategy": "NONE",
"value": "yyyy-MM-dd"
},
"timestampFormat": {
"templatingStrategy": "NONE",
"value": "yyyy-MM-dd'T':mm:ss[.SSS][XXX]"
},
"charToEscapeQuoteEscaping": {
"templatingStrategy": "NONE",
"value": "\\"
},
"emptyValue": {
"templatingStrategy": "NONE",
"value": ""
}
}
}
}
参数 | 类型 | 描述 |
---|---|---|
name |
字符串 | 目标连接的名称。 |
destinationServerType |
字符串 | 根据目标平台设置此值。 对象 SFTP 目标,将其设置为 FILE_BASED_SFTP . |
fileBasedSftpDestination.rootDirectory.templatingStrategy |
字符串 | 必需。使用 PEBBLE_V1 。 |
fileBasedSftpDestination.rootDirectory.value |
字符串 | 目标存储的根目录。 |
fileBasedSftpDestination.hostName.templatingStrategy |
字符串 | 必需。使用 PEBBLE_V1 。 |
fileBasedSftpDestination.hostName.value |
字符串 | 目标存储的主机名。 |
port |
整数 | SFTP文件服务器端口。 |
encryptionMode |
字符串 | 指示是否使用文件加密。 支持的值:
|
fileConfigurations |
不适用 | 参见 文件格式配置 有关如何配置这些设置的详细信息。 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。
创建 Azure Data Lake Storage 目标服务器
您需要创建 Azure Data Lake Storage 目标服务器,类似于配置基于文件的服务器时所显示的服务器 Azure Data Lake Storage 目标。
curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"name":"ADLS destination server",
"destinationServerType":"FILE_BASED_ADLS_GEN2",
"fileBasedAdlsGen2Destination":{
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
}
},
"fileConfigurations": {
"compression": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.compression}}"
},
"fileType": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.fileType}}"
},
"csvOptions": {
"quote": {
"templatingStrategy": "NONE",
"value": "\""
},
"quoteAll": {
"templatingStrategy": "NONE",
"value": "false"
},
"escape": {
"templatingStrategy": "NONE",
"value": "\\"
},
"escapeQuotes": {
"templatingStrategy": "NONE",
"value": "true"
},
"header": {
"templatingStrategy": "NONE",
"value": "true"
},
"ignoreLeadingWhiteSpace": {
"templatingStrategy": "NONE",
"value": "true"
},
"ignoreTrailingWhiteSpace": {
"templatingStrategy": "NONE",
"value": "true"
},
"nullValue": {
"templatingStrategy": "NONE",
"value": ""
},
"dateFormat": {
"templatingStrategy": "NONE",
"value": "yyyy-MM-dd"
},
"timestampFormat": {
"templatingStrategy": "NONE",
"value": "yyyy-MM-dd'T':mm:ss[.SSS][XXX]"
},
"charToEscapeQuoteEscaping": {
"templatingStrategy": "NONE",
"value": "\\"
},
"emptyValue": {
"templatingStrategy": "NONE",
"value": ""
}
}
}
}
参数 | 类型 | 描述 |
---|---|---|
name |
字符串 | 目标连接的名称。 |
destinationServerType |
字符串 | 根据目标平台设置此值。 对象 Azure Data Lake Storage 目标,将其设置为 FILE_BASED_ADLS_GEN2 . |
fileBasedAdlsGen2Destination.path.templatingStrategy |
字符串 | 必需。使用 PEBBLE_V1 。 |
fileBasedAdlsGen2Destination.path.value |
字符串 | 将托管导出文件的目标文件夹的路径。 |
fileConfigurations |
不适用 | 参见 文件格式配置 有关如何配置这些设置的详细信息。 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。
创建 Azure Blob Storage 目标服务器
您需要创建 Azure Blob Storage 目标服务器,类似于配置基于文件的服务器时所显示的服务器 Azure Blob Storage 目标。
curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"name":"Blob destination server",
"destinationServerType":"FILE_BASED_AZURE_BLOB",
"fileBasedAzureBlobDestination":{
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
},
"container":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.container}}"
}
},
"fileConfigurations": {
"compression": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.compression}}"
},
"fileType": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.fileType}}"
},
"csvOptions": {
"quote": {
"templatingStrategy": "NONE",
"value": "\""
},
"quoteAll": {
"templatingStrategy": "NONE",
"value": "false"
},
"escape": {
"templatingStrategy": "NONE",
"value": "\\"
},
"escapeQuotes": {
"templatingStrategy": "NONE",
"value": "true"
},
"header": {
"templatingStrategy": "NONE",
"value": "true"
},
"ignoreLeadingWhiteSpace": {
"templatingStrategy": "NONE",
"value": "true"
},
"ignoreTrailingWhiteSpace": {
"templatingStrategy": "NONE",
"value": "true"
},
"nullValue": {
"templatingStrategy": "NONE",
"value": ""
},
"dateFormat": {
"templatingStrategy": "NONE",
"value": "yyyy-MM-dd"
},
"timestampFormat": {
"templatingStrategy": "NONE",
"value": "yyyy-MM-dd'T':mm:ss[.SSS][XXX]"
},
"charToEscapeQuoteEscaping": {
"templatingStrategy": "NONE",
"value": "\\"
},
"emptyValue": {
"templatingStrategy": "NONE",
"value": ""
}
}
}
}
参数 | 类型 | 描述 |
---|---|---|
name |
字符串 | 目标连接的名称。 |
destinationServerType |
字符串 | 根据目标平台设置此值。 对象 Azure Blob Storage 目标,将其设置为 FILE_BASED_AZURE_BLOB . |
fileBasedAzureBlobDestination.path.templatingStrategy |
字符串 | 必需。使用 PEBBLE_V1 。 |
fileBasedAzureBlobDestination.path.value |
字符串 | 将托管导出文件的目标文件夹的路径。 |
fileBasedAzureBlobDestination.container.templatingStrategy |
字符串 | 必需。使用 PEBBLE_V1 。 |
fileBasedAzureBlobDestination.container.value |
字符串 | 的名称 Azure Blob Storage 此目标使用的容器。 |
fileConfigurations |
不适用 | 参见 文件格式配置 有关如何配置这些设置的详细信息。 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。
创建 Data Landing Zone (DLZ) 目标服务器
您需要创建 Data Landing Zone (DLZ) 目标服务器,类似于配置基于文件的服务器时所显示的服务器 Data Landing Zone (DLZ) 目标。
curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"name":"DLZ destination server",
"destinationServerType":"FILE_BASED_DLZ",
"fileBasedDlzDestination":{
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
},
"useCase": "Your use case"
},
"fileConfigurations": {
"compression": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.compression}}"
},
"fileType": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.fileType}}"
},
"csvOptions": {
"quote": {
"templatingStrategy": "NONE",
"value": "\""
},
"quoteAll": {
"templatingStrategy": "NONE",
"value": "false"
},
"escape": {
"templatingStrategy": "NONE",
"value": "\\"
},
"escapeQuotes": {
"templatingStrategy": "NONE",
"value": "true"
},
"header": {
"templatingStrategy": "NONE",
"value": "true"
},
"ignoreLeadingWhiteSpace": {
"templatingStrategy": "NONE",
"value": "true"
},
"ignoreTrailingWhiteSpace": {
"templatingStrategy": "NONE",
"value": "true"
},
"nullValue": {
"templatingStrategy": "NONE",
"value": ""
},
"dateFormat": {
"templatingStrategy": "NONE",
"value": "yyyy-MM-dd"
},
"timestampFormat": {
"templatingStrategy": "NONE",
"value": "yyyy-MM-dd'T':mm:ss[.SSS][XXX]"
},
"charToEscapeQuoteEscaping": {
"templatingStrategy": "NONE",
"value": "\\"
},
"emptyValue": {
"templatingStrategy": "NONE",
"value": ""
}
}
}
}
参数 | 类型 | 描述 |
---|---|---|
name |
字符串 | 目标连接的名称。 |
destinationServerType |
字符串 | 根据目标平台设置此值。 对象 Data Landing Zone 目标,将其设置为 FILE_BASED_DLZ . |
fileBasedDlzDestination.path.templatingStrategy |
字符串 | 必需。使用 PEBBLE_V1 。 |
fileBasedDlzDestination.path.value |
字符串 | 将托管导出文件的目标文件夹的路径。 |
fileConfigurations |
不适用 | 参见 文件格式配置 有关如何配置这些设置的详细信息。 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。
创建 Google Cloud Storage 目标服务器
您需要创建 Google Cloud Storage 目标服务器,类似于配置基于文件的服务器时所显示的服务器 Google Cloud Storage 目标。
curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"name":"Google Cloud Storage Server",
"destinationServerType":"FILE_BASED_GOOGLE_CLOUD",
"fileBasedGoogleCloudStorageDestination":{
"bucket":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.bucket}}"
},
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
}
},
"fileConfigurations": {
"compression": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.compression}}"
},
"fileType": {
"templatingStrategy": "PEBBLE_V1",
"value": "{{customerData.fileType}}"
},
"csvOptions": {
"quote": {
"templatingStrategy": "NONE",
"value": "\""
},
"quoteAll": {
"templatingStrategy": "NONE",
"value": "false"
},
"escape": {
"templatingStrategy": "NONE",
"value": "\\"
},
"escapeQuotes": {
"templatingStrategy": "NONE",
"value": "true"
},
"header": {
"templatingStrategy": "NONE",
"value": "true"
},
"ignoreLeadingWhiteSpace": {
"templatingStrategy": "NONE",
"value": "true"
},
"ignoreTrailingWhiteSpace": {
"templatingStrategy": "NONE",
"value": "true"
},
"nullValue": {
"templatingStrategy": "NONE",
"value": ""
},
"dateFormat": {
"templatingStrategy": "NONE",
"value": "yyyy-MM-dd"
},
"timestampFormat": {
"templatingStrategy": "NONE",
"value": "yyyy-MM-dd'T':mm:ss[.SSS][XXX]"
},
"charToEscapeQuoteEscaping": {
"templatingStrategy": "NONE",
"value": "\\"
},
"emptyValue": {
"templatingStrategy": "NONE",
"value": ""
}
}
}
}
参数 | 类型 | 描述 |
---|---|---|
name |
字符串 | 目标连接的名称。 |
destinationServerType |
字符串 | 根据目标平台设置此值。 对象 Google Cloud Storage 目标,将其设置为 FILE_BASED_GOOGLE_CLOUD . |
fileBasedGoogleCloudStorageDestination.bucket.templatingStrategy |
字符串 | 必需。使用 PEBBLE_V1 。 |
fileBasedGoogleCloudStorageDestination.bucket.value |
字符串 | 的名称 Google Cloud Storage 要由此目标使用的存储段。 |
fileBasedGoogleCloudStorageDestination.path.templatingStrategy |
字符串 | 必需。使用 PEBBLE_V1 。 |
fileBasedGoogleCloudStorageDestination.path.value |
字符串 | 将托管导出文件的目标文件夹的路径。 |
fileConfigurations |
不适用 | 参见 文件格式配置 有关如何配置这些设置的详细信息。 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。
创建动态架构服务器
在配置从您自己的API端点检索其配置文件架构的目标时,您需要创建类似于以下所示的动态架构服务器。 与静态架构相反,动态架构不使用 profileFields
数组。 相反,动态架构使用动态架构服务器,该服务器连接到您自己的API,并从其中检索架构配置。
curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"name":"Dynamic Schema Server",
"destinationServerType":"URL_BASED",
"urlBasedDestination":{
"url":{
"templatingStrategy":"PEBBLE_V1",
"value":"https://YOUR_API_ENDPOINT/"
}
},
"httpTemplate":{
"httpMethod":"GET"
},
"responseFields":[
{
"templatingStrategy":"PEBBLE_V1",
"value":"{\n \"type\":\"object\",\n \"title\": \"Contact Schema\",\n \"properties\": {\n {% for setDefinition in response.body.items %}\n \"{{setDefinition.key}}\": {\n \"title\" : \"{{setDefinition.name.value}}\",\n \"type\" : \"object\",\n \"properties\": {\n {% for attribute in setDefinition.attributes %}\n \"{{attribute.key}}\": {\n \"title\" : \"{{attribute.name.value}}\",\n \"type\" : \"string\"\n }\n {% if not loop.last %},{%endif%}\n {% endfor %}\n }\n }\n {% if not loop.last %},{%endif%}\n {% endfor %}\n }\n}",
"name":"schema"
}
]
}
参数 | 类型 | 描述 |
---|---|---|
name |
字符串 | 必需。 表示您的动态架构服务器的友好名称,仅对Adobe可见。 |
destinationServerType |
字符串 | 必需。 设置为 URL_BASED 用于动态架构服务器。 |
urlBasedDestination.url.templatingStrategy |
字符串 | 必需.
|
urlBasedDestination.url.value |
字符串 | 必需。 填写Experience Platform应连接到的API端点地址,并检索架构字段,以将其填充为激活工作流映射步骤中的目标字段。 |
httpTemplate.httpMethod |
字符串 | 必需。 Adobe将在对服务器的调用中使用的方法。 对于动态架构服务器,请使用 GET . |
responseFields.templatingStrategy |
字符串 | 必需。使用 PEBBLE_V1 。 |
responseFields.value |
字符串 | 必需。 此字符串是一个字符转义转换模板,它将从合作伙伴API收到的响应转换为将在Platform UI中显示的合作伙伴架构。
|
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。
Destination SDKAPI端点遵循常规Experience PlatformAPI错误消息原则。 请参阅 API状态代码 和 请求标头错误 平台疑难解答指南中的。
阅读本文档后,您现在知道如何通过Destination SDK创建新的目标服务器 /authoring/destination-servers
API端点。
要了解有关可使用此端点执行的操作的更多信息,请参阅以下文章:
要了解此端点在目标创作过程中的适用位置,请参阅以下文章: