DocumentaçãoExperience PlatformGuia de destinos

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

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador
  • Usuário
IMPORTANT
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.
IMPORTANT
Ponto de extremidade de 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. Leia Enviar para revisão um destino criado no Destination SDK para todas as outras etapas que você deve realizar 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 da Destination SDK, você deseja disponibilizar seu destino produzido em todas as organizações da Experience Platform para todos os clientes da Experience Platform usarem;
  • Você faz quaisquer atualizações para suas configurações. As atualizações de configuração são refletidas no destino somente após você enviar uma nova solicitação de publicação, que é aprovada pela equipe do Experience Platform.
IMPORTANT
Todos os nomes e valores de parâmetros com suporte do Destination SDK diferenciam maiúsculas de minúsculas 1}. 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 get-started

Antes de continuar, consulte 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.

Listar solicitações de publicação de destino retrieve-list

Você pode recuperar uma lista de todos os destinos enviados para publicação para sua Organização IMS fazendo uma solicitação GET para o ponto de extremidade /authoring/destinations/publish.

Formato da API

Use o formato de API a seguir para recuperar todas as solicitações de publicação da sua conta.

GET /authoring/destinations/publish

Use o formato de API a seguir para recuperar uma solicitação de publicação específica, definida pelo parâmetro {DESTINATION_ID}.

GET /authoring/destinations/publish/{DESTINATION_ID}

Solicitação

As duas solicitações a seguir recuperam todas as solicitações de publicação para sua Organização IMS ou uma solicitação de publicação específica, dependendo se você passa o parâmetro DESTINATION_ID na solicitação.

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

Recuperar todas as solicitações de publicação
accordion
Solicitação

A solicitação a seguir recuperará a lista de solicitações de publicação que você enviou, com base em IMS Org ID e na configuração da sandbox.

code language-shell 
curl -X GET https://platform.adobe.io/data/core/activation/authoring/destinations/publish \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
accordion
Resposta

A resposta a seguir retorna o status HTTP 200 com uma lista de todos os destinos enviados para publicação aos quais você tem acesso, com base na ID da organização IMS e no nome da sandbox usados. Um configId corresponde à solicitação de publicação para um destino.

code language-json 
{
   "destinationId":"1230e5e4-4ab8-4655-ae1e-a6296b30f2ec",
   "publishDetailsList":[
      {
         "configId":"ab41387c0-4772-4709-a3ce-6d5fee654520",
         "allowedOrgs":[
            "716543205DB85F7F0A495E5B@AdobeOrg"
         ],
         "status":"TEST",
         "destinationType":"DEV"
      },
      {
         "configId":"cd568c67-f25e-47e4-b9a2-d79297a20b27",
         "allowedOrgs":[
            "*"
         ],
         "status":"DEPRECATED",
         "destinationType":"PUBLIC",
         "publishedDate":1630525501009
      },
      {
         "configId":"ef6f07154-09bc-4bee-8baf-828ea9c92fba",
         "allowedOrgs":[
            "*"
         ],
         "status":"PUBLISHED",
         "destinationType":"PUBLIC",
         "publishedDate":1630531586002
      }
   ]
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto
Parâmetro Tipo Descrição
destinationId String A ID de destino da configuração de destino enviada para publicação.
publishDetailsList.configId String A ID exclusiva da solicitação de publicação de destino para o destino enviado.
publishDetailsList.allowedOrgs String

Retorna as organizações da Experience Platform para as quais o destino está disponível.

  • Para "destinationType": "PUBLIC", esse parâmetro retorna "*", o que significa que o destino está disponível para todas as organizações da Experience Platform.
  • Para "destinationType": "DEV", esse parâmetro retorna a ID da Organização da organização que você usou para criar e testar o destino.
publishDetailsList.status String O status da solicitação de publicação de destino. Os valores possíveis são TEST, REVIEW, APPROVED, PUBLISHED, DENIED, REVOKED, DEPRECATED. Destinos com o valor PUBLISHED estão ao vivo e podem ser usados por clientes do Experience Platform.
publishDetailsList.destinationType String O tipo de destino. Os valores podem ser DEV e PUBLIC. DEV corresponde ao destino em sua organização da Experience Platform. PUBLIC corresponde ao destino enviado para publicação. Pense nessas duas opções em termos do Git, onde a versão DEV representa sua ramificação de criação local e a versão PUBLIC representa a ramificação principal remota.
publishDetailsList.publishedDate String A data em que o destino foi enviado para publicação, em época.
Recuperar uma solicitação de publicação específica
accordion
Solicitação
code language-shell 
curl -X GET https://platform.adobe.io/data/core/activation/authoring/destinations/publish/{DESTINATION_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
table 0-row-2 1-row-2
Parâmetro Descrição
{DESTINATION_ID} A ID do destino para o qual você deseja recuperar o status de publicação.
accordion
Resposta

Se você passou um DESTINATION_ID na chamada da API, a resposta retorna o status HTTP 200 com informações detalhadas sobre a solicitação de publicação de destino especificada.

code language-json 
{
   "destinationId":"1230e5e4-4ab8-4655-ae1e-a6296b30f2ec",
   "publishDetailsList":[
      {
         "configId":"123cs780-ce29-434f-921e-4ed6ec2a6c35",
         "allowedOrgs": [
            "*"
         ],
         "status":"PUBLISHED",
         "destinationType": "PUBLIC",
         "publishedDate":"1630617746"
      }
   ]
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto
Parâmetro Tipo Descrição
destinationId String A ID de destino da configuração de destino enviada para publicação.
publishDetailsList.configId String A ID exclusiva da solicitação de publicação de destino para o destino enviado.
publishDetailsList.allowedOrgs String

Retorna as organizações da Experience Platform para as quais o destino está disponível.

  • Para "destinationType": "PUBLIC", esse parâmetro retorna "*", o que significa que o destino está disponível para todas as organizações da Experience Platform.
  • Para "destinationType": "DEV", esse parâmetro retorna a ID da Organização da organização que você usou para criar e testar o destino.
publishDetailsList.status String O status da solicitação de publicação de destino. Os valores possíveis são TEST, REVIEW, APPROVED, PUBLISHED, DENIED, REVOKED, DEPRECATED. Destinos com o valor PUBLISHED estão ao vivo e podem ser usados por clientes do Experience Platform.
publishDetailsList.destinationType String O tipo de destino. Os valores podem ser DEV e PUBLIC. DEV corresponde ao destino em sua organização da Experience Platform. PUBLIC corresponde ao destino enviado para publicação. Pense nessas duas opções em termos do Git, onde a versão DEV representa sua ramificação de criação local e a versão PUBLIC representa a ramificação principal remota.
publishDetailsList.publishedDate String A data em que o destino foi enviado para publicação, em época.

Manipulação de erros de API

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

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6