Query Service Manual da API

Este guia do desenvolvedor fornece etapas para executar várias operações no Adobe Experience Platform Query Service API.

Introdução

Este guia requer uma compreensão funcional dos vários serviços da Adobe Experience Platform envolvidos no uso do Query Service.

  • Query Service: Fornece a capacidade de consultar conjuntos de dados e capturar as consultas resultantes como novos conjuntos de dados em Experience Platform.
  • Experience Data Model (XDM) System: O quadro normalizado pelo qual Experience Platform organiza os dados de experiência do cliente.
  • Sandboxes: Experience Platform 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 usar com sucesso Query Service usando a API .

Lendo exemplos de chamadas de API

Este guia fornece exemplos de chamadas de API para demonstrar como formatar suas solicitações do . Isso inclui caminhos, cabeçalhos necessários e cargas de solicitação formatadas corretamente. O JSON de exemplo retornado nas respostas da API também é fornecido. Para obter informações sobre as convenções usadas nesta documentação para chamadas de API de exemplo, consulte a seção sobre como ler exemplos de chamadas de API no Experience Platform guia de solução de problemas.

Coletar valores para cabeçalhos necessários

Para fazer chamadas para Experience Platform As APIs devem ser concluídas primeiro tutorial de autenticação. A conclusão do tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários em todos Platform Chamadas de API, conforme mostrado abaixo:

  • Autorização: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Todos os recursos em Experience Platform são isoladas em sandboxes virtuais específicas. Todas as solicitações para Platform As APIs exigem um cabeçalho que especifica o nome da sandbox em que a operação ocorrerá:

  • x-sandbox-name: {SANDBOX_NAME}
OBSERVAÇÃO

Para obter mais informações sobre como trabalhar com sandboxes no Experience Platform, consulte o documentação de visão geral das sandboxes.

Exemplos de chamadas de API

Agora que você entende quais cabeçalhos devem ser usados, você está pronto para começar a fazer chamadas para o Query Service API. Os seguintes documentos percorrem as várias chamadas de API que você pode fazer usando o Query Service API. Cada chamada de exemplo inclui o formato da API geral, uma solicitação de amostra que mostra os cabeçalhos necessários e uma resposta de amostra.

Próximas etapas

Agora que você aprendeu a fazer chamadas usando o Query Service Você pode criar suas próprias consultas não interativas. Para obter mais informações sobre como criar consultas, leia o Guia de referência SQL.

Nesta página