O /authoring/testing/template/render
endpoint ajuda a visualizar como o modelo campos de dados do cliente definido na configuração de destino, seria parecido.
O endpoint gera valores aleatórios para os campos de dados do cliente e os retorna na resposta. Isso ajuda a validar a estrutura semântica dos campos de dados do cliente, como nomes de bucket ou caminhos de pasta.
Antes de continuar, reveja o guia de introdução para obter informações importantes que você precisa saber para fazer chamadas para a API com sucesso, incluindo como obter a permissão de criação de destino necessária e os cabeçalhos necessários.
Antes de usar a variável /template/render
, certifique-se de atender às seguintes condições:
Você tem um destino com base em arquivo existente criado por meio do Destination SDK e pode vê-lo em seu catálogo de destinos.
Para fazer a solicitação da API com êxito, é necessário a ID da instância de destino correspondente à instância de destino que você testará. Obtenha a ID da instância de destino que você deve usar na chamada da API, do URL, ao navegar em uma conexão com seu destino na interface do usuário da plataforma.
Formato da API
POST /authoring/testing/template/render/destination
Para ilustrar o comportamento desse ponto de extremidade de API, considere um destino baseado em arquivo com a seguinte configuração de campos de dados do cliente:
"fileBasedS3Destination":{
"bucket":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.bucket}}"
},
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
}
}
Solicitação
A solicitação abaixo chama a função /authoring/testing/template/render
endpoint, que retorna uma resposta com valores gerados aleatoriamente para os dois campos de dados do cliente mencionados acima.
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}}"
}
}'
Parâmetros | Descrição |
---|---|
destinationId |
A ID do configuração de destino que você está testando. |
templates |
Os nomes de campo modelos definidos em configuração do servidor de destino. |
Resposta
Uma resposta bem-sucedida retorna um HTTP 200 OK
e o corpo inclui valores gerados aleatoriamente para seus campos modelos.
Essa resposta pode ajudar a validar a estrutura correta dos campos de dados do cliente, como nomes de bucket ou caminhos de pasta.
{
"results": {
"bucket": "hfWpE-bucket",
"path": "hfWpE-bucket/ceC"
}
}
Os pontos de extremidade da API do Destination SDK seguem os princípios gerais da mensagem de erro da API do Experience Platform. Consulte Códigos de status da API e erros do cabeçalho da solicitação no guia de solução de problemas da plataforma.
Depois de ler este documento, você agora sabe como validar a configuração do campo de dados do cliente definida em servidor de destino.