Introdução à API de assimilação de dados

Usando endpoints da API de assimilação de dados, você pode executar operações CRUD básicas para assimilar dados no Adobe Experience Platform.

A utilização dos guias de API exige uma compreensão funcional de vários serviços da Adobe Experience Platform envolvidos no trabalho com dados. Antes de usar a API de assimilação de dados, consulte a documentação dos seguintes serviços:

  • Assimilação em lote: permite assimilar dados na Adobe Experience Platform como arquivos em lote.
  • Real-Time Customer Profile: fornece um perfil de cliente unificado em tempo real com base em dados agregados de várias fontes.
  • Experience Data Model (XDM): a estrutura padronizada pela qual a Platform organiza os dados de experiência do cliente.
  • 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 informações adicionais que você precisará saber para fazer chamadas com êxito para o Profile Endpoints de API.

Leitura de chamadas de API de amostra

A documentação da API de assimilação de dados fornece exemplos de chamadas de API para demonstrar como formatar solicitações corretamente. 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.

Cabeçalhos obrigatórios

A documentação da API também exige que você tenha concluído a tutorial de autenticação para fazer chamadas com êxito para o Platform pontos finais. Concluir o tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários no Experience Platform Chamadas de API, conforme mostrado abaixo:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Todas as solicitações com uma carga no corpo da solicitação (como chamadas POST, PUT e PATCH) devem incluir uma Content-Type cabeçalho. Os valores aceitos específicos para cada chamada são fornecidos nos parâmetros de chamada.

Todos os recursos em Experience Platform são isolados em sandboxes virtuais específicas. 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}

Para obter mais informações sobre sandboxes no Platform, consulte o documentação de visão geral da sandbox.

Nesta página