Criar uma solicitação de publicação de destino

Última atualização em 2023-10-31
  • Tópicos
  • Destinations
    Exibir mais informações sobre este tópico
  • Criado para:
  • Developer
    User
    Admin
    Leader
IMPORTANTE

Você só precisará usar esse endpoint de API se estiver enviando um destino produtizado (público), para ser usado por outros clientes do Experience Platform. Se você estiver criando um destino privado para uso próprio, não será necessário enviar formalmente o destino usando a API de publicação.

IMPORTANTE

Ponto de acesso da API: platform.adobe.io/data/core/activation/authoring/destinations/publish

Depois de configurar e testar seu destino, você pode enviá-lo ao Adobe para revisão e publicação. Ler Enviar para análise um destino criado no Destination SDK para todas as outras etapas, é necessário fazer como parte do processo de envio do destino.

Use o endpoint da API de destinos de publicação para enviar uma solicitação de publicação quando:

  • Como parceiro de Destination SDK, você deseja disponibilizar seu destino produzido em todas as organizações de Experience Platform para que todos os clientes de Experience Platform usem;
  • Você faz quaisquer atualizações para suas configurações. As atualizações de configuração são refletidas no destino somente após o envio de uma nova solicitação de publicação, que é aprovada pela equipe do Experience Platform.
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 de publicação 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.

Enviar uma configuração de destino para publicação

É possível enviar uma configuração de destino para publicação fazendo uma solicitação POST para o /authoring/destinations/publish terminal.

Formato da API

POST /authoring/destinations/publish
 Solicitação

A solicitação a seguir envia um destino para publicação, entre as organizações configuradas pelos parâmetros fornecidos na carga. A carga abaixo inclui todos os parâmetros aceitos pelo /authoring/destinations/publish terminal.

curl -X POST https://platform.adobe.io/data/core/activation/authoring/destinations/publish \
 -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 '
{
   "destinationId":"1230e5e4-4ab8-4655-ae1e-a6296b30f2ec",
   "destinationAccess":"ALL"
}
Parâmetro Tipo Descrição
destinationId String A ID de destino da configuração de destino que você está enviando para publicação. Obter a ID de destino de uma configuração de destino usando o recuperar uma configuração de destino chamada à API.
destinationAccess String Uso ALL para que seu destino apareça no catálogo para todos os clientes do Experience Platform.
 Resposta

Uma resposta bem-sucedida retorna o status HTTP 201 com detalhes da solicitação de publicação de destino.

Manipulação de erros de API

Os endpoints da API Destination SDK seguem os princípios gerais de mensagem de erro da API Experience Platform. Consulte Códigos de status da API e erros no cabeçalho da solicitação no guia de solução de problemas da Platform.

Próximas etapas

Depois de ler este documento, agora você sabe como enviar uma solicitação de publicação para o seu destino. A equipe do Adobe Experience Platform revisará sua solicitação de publicação e entrará em contato com você em cinco dias úteis.

Nesta página