Excluir uma conta de destino usando a API de Serviço de Fluxo
Destinations são integrações pré-criadas com plataformas de destino que permitem a ativação contínua de dados do Adobe Experience Platform. Você pode usar destinos para ativar seus dados conhecidos e desconhecidos para campanhas de marketing entre canais, campanhas por email, publicidade direcionada e muitos outros casos de uso.
Antes de ativar os dados, você precisa se conectar ao destino configurando primeiro uma conta de destino. Este tutorial aborda as etapas para excluir contas de destino que não são mais necessárias usando o Flow Service API.
Introdução get-started
Este tutorial requer que você tenha uma ID de conexão válida. A ID de conexão representa a conexão da conta com o destino. Se você não tiver uma ID de conexão válida, selecione o destino escolhido na catálogo de destinos e siga as etapas descritas em conectar ao destino antes de tentar este tutorial.
Este tutorial também requer que você tenha uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:
- Destinos: Destinations são integrações pré-criadas com plataformas de destino que permitem a ativação contínua de dados do Adobe Experience Platform. Você pode usar destinos para ativar seus dados conhecidos e desconhecidos para campanhas de marketing entre canais, campanhas por email, publicidade direcionada e muitos outros casos de uso.
- Sandboxes: Experience Platform O fornece sandboxes virtuais que particionam uma única Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.
As seções a seguir fornecem as informações adicionais que você precisará saber para excluir com êxito uma conta de destino usando o Flow Service API.
Leitura de chamadas de API de amostra reading-sample-api-calls
Este tutorial fornece exemplos de chamadas de API para demonstrar como formatar suas solicitações. Isso inclui caminhos, cabeçalhos necessários e cargas de solicitação formatadas corretamente. O exemplo de JSON retornado nas respostas da API também é fornecido. Para obter informações sobre as convenções usadas na documentação para chamadas de API de exemplo, consulte a seção sobre como ler chamadas de API de exemplo no Experience Platform guia de solução de problemas.
Coletar valores para cabeçalhos obrigatórios gather-values-for-required-headers
Para fazer chamadas para Platform APIs, primeiro conclua o tutorial de autenticação. Concluir o tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários em todos os Experience Platform Chamadas de API, conforme mostrado abaixo:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Todos os recursos em Experience Platform, incluindo as que pertencem a Flow Service, são isolados em sandboxes virtuais específicas. Todas as solicitações para Platform As APIs exigem um cabeçalho que especifique o nome da sandbox em que a operação ocorrerá:
x-sandbox-name: {SANDBOX_NAME}
x-sandbox-name cabeçalho não for especificado, as solicitações serão resolvidas no prod sandbox.Todas as solicitações que contêm uma carga (POST, PUT, PATCH) exigem um cabeçalho de tipo de mídia adicional:
Content-Type: application/json
Localize a ID de conexão da conta de destino que você deseja excluir find-connection-id
A primeira etapa ao excluir uma conta de destino é descobrir a ID de conexão que corresponde à conta de destino que você deseja excluir.
Na interface do usuário do Experience Platform, navegue até Destinos > Contas e selecione a conta que deseja excluir selecionando o número na caixa Destinos coluna.
Em seguida, você pode recuperar a ID de conexão da conta de destino da URL no navegador.
Excluir conexão delete-connection
Para excluir fluxos de dados existentes, consulte as páginas abaixo:
- Usar a interface do Experience Platform excluir fluxos de dados existentes;
- Usar a API do serviço de fluxo para excluir fluxos de dados existentes.
Depois de ter uma ID de conexão e verificar se não há fluxos de dados para a conta de destino, execute uma solicitação DELETE para a Flow Service API.
Formato da API
DELETE /connections/{CONNECTION_ID}
{CONNECTION_ID}id valor da conexão que deseja excluir.Solicitação
curl -X DELETE \
'https://platform.adobe.io/data/foundation/flowservice/connections/c8622ec7-7d94-44a5-a35a-ffcc6bdcc384' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Resposta
Uma resposta bem-sucedida retorna o status HTTP 204 (Sem conteúdo) e um corpo em branco. Você pode confirmar a exclusão tentando uma solicitação de pesquisa (GET) para a conexão. A API retornará um erro HTTP 404 (Não encontrado), indicando que a conta de destino foi excluída.
Manipulação de erros de API api-error-handling
Os endpoints de API neste tutorial 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
Ao seguir este tutorial, você usou com êxito o Flow Service API para excluir contas de destino existentes. Para obter mais informações sobre o uso de destinos, consulte visão geral dos destinos.