Atualizar uma configuração do servidor de destino

Esta página exemplifica a solicitação de API e a carga que você pode usar para atualizar uma configuração existente do servidor de destino usando o /authoring/destination-servers Endpoint da API.

DICA

Qualquer operação de atualização em destinos de produção/públicos estará visível somente após o uso do API de publicação e envie a atualização para revisão do Adobe.

Para obter uma descrição detalhada dos recursos que você pode configurar por meio desse endpoint, leia os seguintes artigos:

IMPORTANTE

Todos os nomes e valores de parâmetros compatíveis com o Destination SDK são diferencia maiúsculas de minúsculas. Para evitar erros de diferenciação entre maiúsculas e minúsculas, use os nomes e valores dos parâmetros exatamente como mostrado na documentação.

Introdução às operações de API do servidor de destino

Antes de continuar, reveja o guia de introdução para obter informações importantes que você precisa saber para fazer chamadas com êxito para a API, incluindo como obter a permissão de criação de destino e os cabeçalhos necessários.

Atualizar uma configuração do servidor de destino

Você pode atualizar um existente configuração do servidor de destino fazendo uma PUT solicitação à /authoring/destination-servers terminal com a carga atualizada.

DICA

Ponto de acesso da API: platform.adobe.io/data/core/activation/authoring/destination-servers

Para obter uma configuração existente do servidor de destino e suas {INSTANCE_ID}, consulte o artigo sobre recuperando uma configuração do servidor de destino.

Formato da API

PUT /authoring/destination-servers/{INSTANCE_ID}

Parâmetro	Descrição
`{INSTANCE_ID}`	A ID da configuração do servidor de destino que você deseja atualizar. Para obter uma configuração existente do servidor de destino e suas `{INSTANCE_ID}`, consulte Recuperar uma configuração do servidor de destino.

As solicitações a seguir atualizam uma configuração existente do servidor de destino, configurada pelos parâmetros fornecidos na carga.

Selecione cada guia abaixo para visualizar o conteúdo correspondente.

Solicitação

curl -X PUT https://platform.adobe.io/data/core/activation/authoring/destination-servers\{INSTANCE_ID} \
 -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":"PUT",
      "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"
   }
}

Parâmetro	Tipo	Descrição
`name`	String	Obrigatório. Representa um nome amigável do servidor, visível somente para o Adobe. Este nome não está visível para parceiros ou clientes. Exemplo `Moviestar destination server`.
`destinationServerType`	String	Obrigatório. Defina como `URL_BASED` para destinos em tempo real (transmissão).
`urlBasedDestination.url.templatingStrategy`	String	Obrigatório. Uso `PEBBLE_V1` se o Adobe precisar transformar o URL no `value` abaixo. Use essa opção se você tiver um terminal como: `https://api.moviestar.com/data/{{customerData.region}}/items`. Uso `NONE` se nenhuma transformação for necessária no lado do Adobe, por exemplo, se você tiver um terminal como: `https://api.moviestar.com/data/items`.
`urlBasedDestination.url.value`	String	Obrigatório. Preencha o endereço do endpoint da API ao qual o Experience Platform deve se conectar.
`httpTemplate.httpMethod`	String	Obrigatório. O método que o Adobe usará nas chamadas para o servidor. As opções são `GET`, `PUT`, `PUT`, `DELETE`, `PATCH`.
`httpTemplate.requestBody.templatingStrategy`	String	Obrigatório. Use `PEBBLE_V1`.
`httpTemplate.requestBody.value`	String	Obrigatório. Essa string é a versão com escape de caracteres que transforma os dados de clientes da Platform no formato esperado pelo seu serviço. Para obter informações sobre como gravar o template, leia o Uso da seção de modelos. Para obter mais informações sobre o escape de caracteres, consulte o RFC JSON padrão, seção sete. Para obter um exemplo de uma transformação simples, consulte Atributos do perfil transformação.
`httpTemplate.contentType`	String	Obrigatório. O tipo de conteúdo que seu servidor aceita. Este valor é mais provável `application/json`.

Resposta