A Adobe Experience Platform permite que os dados sejam ingeridos de fontes externas e, ao mesmo tempo, fornece a você a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços Platform. Você pode assimilar dados de várias fontes, como aplicativos Adobe, armazenamentos baseados em nuvem, bancos de dados e muitas outras.
Flow Service é usada para coletar e centralizar dados do cliente de várias fontes diferentes no Adobe Experience Platform. O serviço fornece uma interface de usuário e uma RESTful API a partir da qual todas as fontes compatíveis são conectáveis.
Este tutorial aborda as etapas para excluir usando o Flow Service API.
Este tutorial requer que você tenha uma ID de conexão válida. Se você não tiver uma ID de conexão válida, selecione seu conector de opção na visão geral das fontes e siga as etapas descritas antes de tentar este tutorial.
Este tutorial também exige que você tenha uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:
As seções a seguir fornecem informações adicionais que você precisará saber para excluir com êxito uma conexão usando a API Flow Service.
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 JSON de amostra retornado em respostas de API também é fornecido. Para obter informações sobre as convenções usadas na documentação para chamadas de API de amostra, consulte a seção em como ler chamadas de API de exemplo no guia de solução de problemas Experience Platform.
Para fazer chamadas para Platform APIs, você deve primeiro concluir o tutorial de autenticação. A conclusão do tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários em todas as chamadas de API Experience Platform, como mostrado abaixo:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {IMS_ORG}
Todos os recursos em Experience Platform, incluindo os pertencentes a Flow Service, são isolados para caixas de proteção virtuais específicas. Todas as solicitações para Platform APIs exigem um cabeçalho que especifique o nome da caixa de proteção em que a operação ocorrerá:
x-sandbox-name: {SANDBOX_NAME}
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
Este tutorial usa o conector de origem do Blob do Azure como exemplo, mas as etapas descritas se aplicam a qualquer um dos conectores de origem disponíveis.
A primeira etapa para atualizar suas informações de conexão é recuperar detalhes de conexão usando sua ID de conexão.
Formato da API
GET /connections/{CONNECTION_ID}
Parâmetro | Descrição |
---|---|
{CONNECTION_ID} |
O valor exclusivo id para a conexão que você deseja recuperar. |
Solicitação
As informações a seguir recuperam informações relacionadas à sua ID de conexão.
curl -X GET \
'https://platform.adobe.io/data/foundation/flowservice/connections/dd3631cd-d0ea-4fea-b631-cdd0ea6fea21' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Resposta
Uma resposta bem-sucedida retorna os detalhes atuais de sua conexão, incluindo suas credenciais, o identificador exclusivo (id
) e a versão.
{
"items": [
{
"createdAt": 1603514659165,
"updatedAt": 1603514659165,
"createdBy": "{CREATED_BY}",
"updatedBy": "{UPDATED_BY}",
"createdClient": "{CREATED_CLIENT}",
"updatedClient": "{UPDATED_CLIENT",
"sandboxId": "{SANDBOX_ID}",
"sandboxName": "{SANDBOX_NAME}",
"id": "dd3631cd-d0ea-4fea-b631-cdd0ea6fea21",
"name": "Test Azure Blob Connector",
"description": "A test connector for Azure Blob",
"connectionSpec": {
"id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
"version": "1.0"
},
"state": "enabled",
"auth": {
"specName": "ConnectionString",
"params": {
"connectionString": "xxxx"
}
},
"version": "\"07001eed-0000-0200-0000-5f93b1250000\"",
"etag": "\"07001eed-0000-0200-0000-5f93b1250000\""
}
]
}
Depois de ter uma ID de conexão existente, execute uma solicitação DELETE para a API Flow Service.
Formato da API
DELETE /connections/{CONNECTION_ID}
Parâmetro | Descrição |
---|---|
{CONNECTION_ID} |
O valor exclusivo id para a conexão que você deseja excluir. |
Solicitação
curl -X DELETE \
'https://platform-int.adobe.io/data/foundation/flowservice/connections/dd3631cd-d0ea-4fea-b631-cdd0ea6fea21' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-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.
Ao seguir este tutorial, você utilizou com êxito a API Flow Service para excluir contas existentes.
Para obter etapas sobre como executar essas operações usando a interface do usuário, consulte o tutorial em excluir contas na interface do usuário