Introdução à API de assimilação de dados getting-started

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 fornece sandboxes virtuais que particionam uma única instância do 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 pontos de extremidade de API Profile.

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 conteúdos de solicitação formatados corretamente. Também fornece exemplos de JSON retornado nas respostas da API. 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 guia de solução de problemas Experience Platform.

Cabeçalhos obrigatórios

A documentação da API também requer que você tenha concluído o tutorial de autenticação para fazer chamadas com êxito para pontos de extremidade Platform. Concluir o tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários nas chamadas de API Experience Platform, 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 um cabeçalho Content-Type. Os valores aceitos específicos para cada chamada são fornecidos nos parâmetros de chamada.

Todos os recursos em Experience Platform estão isolados em sandboxes virtuais específicas. As solicitações para Platform 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 em Platform, consulte a documentação de visão geral da sandbox.

recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a