Adobe Experience Platform Identity Service O gerencia a identificação entre dispositivos, canais e quase em tempo real dos clientes no que é conhecido como um gráfico de identidade na Adobe Experience Platform.
Este guia requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:
As seções a seguir fornecem informações adicionais que você precisará saber ou ter em mãos para fazer chamadas com êxito para o Identity Service API.
Este guia 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 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.
Para fazer chamadas para Platform APIs, 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 todos os Experience Platform Chamadas de API, conforme mostrado abaixo:
{ACCESS_TOKEN}
{API_KEY}
{ORG_ID}
Todos os recursos em Experience Platform são isolados em sandboxes virtuais específicas. Todas as solicitações para Platform As APIs exigem um cabeçalho que especifique o nome da sandbox em que a operação ocorrerá:
{SANDBOX_NAME}
Para obter mais informações sobre sandboxes no Platform, consulte o documentação de visão geral da sandbox.
Todas as solicitações que contêm uma carga (POST, PUT, PATCH) exigem um cabeçalho adicional:
A variável Identity Service A API emprega endpoints específicos da região que exigem a inclusão de um {REGION}
como parte do caminho da solicitação. Durante o provisionamento da organização, uma região é determinada e armazenada no perfil da organização. Usar a região correta com cada endpoint garante que todas as solicitações feitas usando o Identity Service As APIs são roteadas para a região apropriada.
Atualmente, há duas regiões compatíveis com o Identity Service APIs: VA7 e NLD2.
A tabela abaixo mostra caminhos de exemplo usando regiões:
Serviço de | Região: VA7 | Região: NLD2 |
---|---|---|
Identity Service API | https://platform-va7.adobe.io/data/core/identity/ | https://platform-nld2.adobe.io/data/core/identity/ |
Identity Namespace API | https://platform-va7.adobe.io/data/core/namespace/ | https://platform-nld2.adobe.io/data/core/idnamespace |
As solicitações feitas sem especificar uma região podem resultar no roteamento de chamadas para a região incorreta ou fazer com que as chamadas falhem inesperadamente.
Se não conseguir localizar a região no perfil da organização, entre em contato com o administrador do sistema para obter suporte.
Os parâmetros de identidade usados nesses serviços podem ser expressos de uma das duas formas: composta ou XID.
Identidades compostas são construções que incluem o valor de ID e o namespace. Ao usar identidades compostas, o namespace pode ser fornecido por qualquer nome (namespace.code
) ou ID (namespace.id
).
Quando uma identidade é persistente, Identity Service O gera e atribui uma ID a essa identidade, chamada de ID nativa ou XID. Todas as variações de APIs de cluster e mapeamento oferecem suporte a identidades compostas e XID em suas solicitações e respostas. Um dos parâmetros é obrigatório - xid
ou combinação de [ns
ou nsid
] e id
para usar essas APIs.
Para limitar o conteúdo nas respostas, as APIs adaptam suas respostas ao tipo de construção de identidade usada. Ou seja, se você passar XID, suas respostas terão XIDs. Se você passar identidades compostas, a resposta seguirá a estrutura usada na solicitação.
Os exemplos neste documento não abrangem a funcionalidade completa do Identity Service API. Para obter a API completa, consulte a Referência da API do Swagger.
Todas as identidades retornadas estarão no formato XID nativo quando o XID nativo for usado na solicitação. É recomendado usar o formulário de ID/namespace. Para obter mais informações, consulte a seção sobre obter o XID de uma identidade.
Agora que você reuniu as credenciais necessárias, pode continuar lendo o restante do guia do desenvolvedor. Cada seção fornece informações importantes sobre seus endpoints e demonstra exemplos de chamadas de API para executar operações CRUD. Cada chamada inclui o formato da API geral, uma solicitação de amostra mostrando os cabeçalhos necessários e cargas úteis formatadas corretamente e uma resposta de amostra para uma chamada bem-sucedida.