Schema Registry Guia da API

O Schema Registry é usado para acessar a Biblioteca de schemas no Adobe Experience Platform, fornecendo uma interface do usuário e a API RESTful da qual todos os recursos de biblioteca disponíveis são acessíveis.

A API do Registro de Esquema fornece vários endpoints que permitem gerenciar programaticamente todos os esquemas e recursos relacionados do Experience Data Model (XDM) disponíveis para você na Platform. Isso inclui aqueles definidos pelo Adobe, Experience Platform parceiros e fornecedores cujos aplicativos você usa.

Esses endpoints são descritos abaixo. Visite os guias de ponto de extremidade individuais para obter detalhes e consulte o guia de introdução para obter informações importantes sobre cabeçalhos necessários, como ler chamadas de API de exemplo e muito mais.

IMPORTANTE

O XDM usa a formatação Esquema JSON para descrever e validar a estrutura dos dados de experiência do cliente assimilados. Antes de trabalhar com a API do Registro de Schema, é altamente recomendável revisar a documentação oficial do Esquema JSON para obter uma melhor compreensão dessa tecnologia subjacente.

Para exibir todos os pontos de extremidade disponíveis e operações CRUD, visite a Referência da API do Registro de Schema.

Esquemas

Os esquemas XDM representam e validam a estrutura e o formato dos dados assimilados no Platform. Um schema é composto de uma classe e zero ou mais grupos de campos de schema. Você pode criar, exibir, editar e excluir esquemas usando o terminal /schemas. Para saber como usar esse endpoint, consulte o guia do endpoint de schemas.

Para obter um guia passo a passo sobre como criar um esquema completo na API do Registro de Schema, incluindo a criação e adição de grupos de campos e tipos de dados, consulte o tutorial de criação de esquema de API.

Comportamentos

Os comportamentos definem a natureza dos dados descritos por um schema. Cada classe XDM deve referenciar um comportamento específico, que todos os esquemas que empregam essa classe herdarão. Consulte o guia do ponto de extremidade de comportamentos para saber como visualizar os comportamentos disponíveis na API.

Classes

Uma classe define a estrutura base das propriedades comuns que todos os schemas baseados nessa classe devem conter e determina quais grupos de campos estão qualificados para uso nesses schemas. Cada classe deve ser associada a um comportamento existente. Consulte o guia de ponto de extremidade de classes para obter detalhes sobre como trabalhar com classes na API.

Grupos de campos

Grupos de campos são componentes reutilizáveis que definem um ou mais campos que representam um conceito específico, como uma pessoa individual, um endereço de correspondência ou um ambiente de navegador da Web. Os grupos de campos devem ser incluídos como parte de um schema que implementa uma classe compatível, dependendo do comportamento dos dados que representam (registro ou série de tempo). Consulte o guia de ponto de extremidade de grupos de campo para saber como trabalhar com grupos de campo na API.

Tipos de dados

Os tipos de dados são usados como campos do tipo referência em classes ou grupos de campos da mesma forma que os campos literais básicos, sendo a principal diferença que os tipos de dados podem definir vários subcampos. Embora semelhantes a grupos de campos, na medida em que permitem o uso consistente de uma estrutura de vários campos, os tipos de dados são mais flexíveis porque podem ser incluídos em qualquer lugar na estrutura do schema, enquanto os grupos de campos só podem ser adicionados no nível raiz. Consulte o guia de ponto de extremidade de tipos de dados para obter mais informações sobre como trabalhar com tipos de dados na API.

Descritores

Os descritores são conjuntos de metadados que são atribuídos a campos específicos em um esquema, fornecendo vários detalhes contextuais, incluindo como esses campos (e o próprio schema) estão relacionados a outros esquemas. Cada esquema pode ter uma ou mais entidades de descritor aplicadas a ele, e há vários tipos diferentes de descritor para servir fins diferentes. Consulte o guia do ponto de extremidade dos descritores para obter mais informações sobre como trabalhar com descritores na API e uma visão geral dos diferentes tipos de descritores e seus casos de uso.

Uniões

Embora a Platform permita compor esquemas para casos de uso específicos, também permite compor uma "união" de esquemas pertencentes a uma classe específica. Um schema de união agrega os campos de todos os schemas que compartilham a mesma classe em uma única representação. Ao ativar um schema para uso com Real-time Customer Profile, esse schema é incluído na união para sua classe específica. Dessa forma, os schemas de união não podem ser editados diretamente e só podem ser afetados pela inclusão ou exclusão de schemas para uso no Perfil.

Para saber como visualizar sindicatos na API do Registro de Schema, consulte o Guia de ponto de extremidade de sindicatos.

Exportar/importar

A API do Registro de Schema permite transferir e compartilhar recursos XDM entre sandboxes e organizações IMS. Para qualquer esquema, grupo de campos ou tipo de dados, é possível gerar uma carga de exportação contendo a estrutura do recurso e quaisquer recursos dependentes. Essa carga pode ser usada para importar o recurso para uma sandbox de destino e a IMS Org.

Consulte o guia de endpoints de exportação/importação para obter mais informações sobre como usar esses endpoints.

Dados de exemplo

Você pode gerar dados de amostra para qualquer esquema especificado na Biblioteca de Esquemas. O objeto de resposta retornado pode ser usado como uma fonte de assimilação de dados.

Consulte o guia de ponto de extremidade de dados de amostra para obter mais informações sobre o uso desse ponto de extremidade.

Log de auditoria

O Registro de Esquema mantém um log de todas as alterações que ocorreram em um recurso (classe, grupo de campos, tipo de dados ou esquema) entre diferentes atualizações. Você pode recuperar o log de um recurso específico fornecendo seu $id ou meta:altId no caminho de uma solicitação GET para esse terminal.

Consulte o guia de ponto de extremidade do log de auditoria para obter mais informações sobre o uso desse ponto de extremidade.

Próximas etapas

Para começar a fazer chamadas usando a API do Registro de Schema, leia o guia de introdução e selecione um dos guias de ponto de extremidade para saber como usar endpoints específicos.

Nesta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now