Introdução às fontes de autoatendimento (SDK de transmissão)
Fontes de autoatendimento (Streaming SDK) permitem integrar sua própria fonte para trazer dados de transmissão para a Adobe Experience Platform. Este documento fornece uma introdução aos conceitos principais que você precisa saber antes de tentar fazer chamadas para a Flow Service API.
Processo de alto nível
O processo passo a passo para configurar seu código-fonte no Experience Platform está descrito abaixo:
Integração
Documentação
- Para começar a documentar sua origem, leia a visão geral sobre como criar documentação para Fontes de Autoatendimento.
- Leia o guia em usando a interface da Web do GitHub para obter etapas sobre como criar a documentação usando o GitHub.
- Leia o guia em usando um editor de texto para obter as etapas sobre como criar a documentação usando o computador local.
- Use o modelo de documentação da API de Streaming do SDK para documentar sua origem na API.
- Use o modelo de documentação da interface do SDK de Streaming para documentar sua origem na interface.
Você também pode baixar os modelos de documentação abaixo:
Pré-requisitos
Para usar as Fontes de autoatendimento (SDK de transmissão), você deve garantir que tenha acesso a uma organização de sandbox provisionada com as Fontes do Adobe Experience Platform.
Este guia também requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:
- Fontes: o Experience Platform permite a assimilação de dados de várias fontes, ao mesmo tempo em que fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços do Experience Platform.
- Sandboxes: a Experience Platform fornece sandboxes virtuais que particionam uma única instância do Experience Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.
Leitura de chamadas de API de amostra
A documentação das Fontes de Autoatendimento (SDK de Streaming) e da API do Flow Service fornece exemplos de chamadas de API para demonstrar como formatar suas solicitações. 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 do Experience Platform.
Coletar valores para cabeçalhos obrigatórios
Para fazer chamadas para APIs do Experience Platform, 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 todas as chamadas de API da Experience Platform, conforme mostrado abaixo:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Todos os recursos no Experience Platform, incluindo aqueles pertencentes a Flow Service, são isolados para sandboxes virtuais específicas. Todas as solicitações para APIs do Experience Platform exigem um cabeçalho que especifique o nome da sandbox em que a operação ocorrerá:
x-sandbox-name: {SANDBOX_NAME}
Todas as solicitações que contêm um conteúdo (POST, PUT, PATCH) exigem um cabeçalho adicional:
Content-Type: application/json
Próximas etapas
Para começar a criar uma nova fonte com Fontes de Autoatendimento (SDK de Streaming), consulte o tutorial em criação de uma nova fonte.