Fundamentos da API do Experience Platform

As APIs do Adobe Experience Platform utilizam várias tecnologias e sintaxes subjacentes que são importantes para entender a fim de gerenciar com eficácia o JSON Platform recursos. Este documento fornece uma breve visão geral dessas tecnologias, bem como links para a documentação externa para obter mais informações.

Ponteiro JSON

Ponteiro JSON é uma sintaxe de sequência de caracteres padronizada (RFC 6901) para identificar valores específicos em documentos JSON. Um ponteiro JSON é uma string de tokens separados por / caracteres, que especificam chaves de objeto ou índices de matriz, e os tokens podem ser uma string ou um número. As strings de ponteiro JSON são usadas em muitas operações de PATCH para Platform APIs, conforme descrito posteriormente neste documento. Para obter mais informações sobre o ponteiro JSON, consulte o Documentação de visão geral do ponteiro JSON.

Exemplo de objeto de esquema JSON

O JSON a seguir representa um esquema XDM simplificado cujos campos podem ser referenciados usando strings de ponteiro JSON. Observe que todos os campos que foram adicionados usando grupos de campos de esquema personalizados (como loyaltyLevel) são namespacadas em uma _{TENANT_ID} , enquanto os campos que foram adicionados usando grupos de campos principais (como fullName) não.

{
  "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/85a4bdaa168b01bf44384e049fbd3d2e9b2ffaca440d35b9",
  "meta:altId": "_{TENANT_ID}.schemas.85a4bdaa168b01bf44384e049fbd3d2e9b2ffaca440d35b9",
  "meta:resourceType": "schemas",
  "version": "1.0",
  "title": "Example schema",
  "type": "object",
  "description": "This is an example schema.",
  "properties": {
    "_{TENANT_ID}": {
      "type": "object",
      "properties": {
        "loyaltyLevel": {
          "title": "Loyalty Level",
          "description": "",
          "type": "string",
          "isRequired": false,
          "enum": [
            "platinum",
            "gold",
            "silver",
            "bronze"
          ]
        }
      }
    },
    "person": {
      "title": "Person",
      "description": "An individual actor, contact, or owner.",
      "type": "object",
      "properties": {
        "name": {
          "title": "Full name",
          "description": "The person's full name.",
          "type": "object",
          "properties": {
            "fullName": {
              "title": "Full name",
              "type": "string",
              "description": "The full name of the person, in writing order most commonly accepted in the language of the name.",
            },
            "suffix": {
              "title": "Suffix",
              "type": "string",
              "description": "A group of letters provided after a person's name to provide additional information. The `suffix` is used at the end of someones name. For example Jr., Sr., M.D., PhD, I, II, III, etc.",
            }
          },
          "meta:referencedFrom": "https://ns.adobe.com/xdm/context/person-name",
          "meta:xdmField": "xdm:name"
        }
      }
    }
  }
}

Exemplo de ponteiros JSON com base no objeto de esquema

Ponteiro JSON Resolve para
"/title" "Example schema"
"/properties/person/properties/name/properties/fullName" (Retorna uma referência à variável fullName , fornecido por um grupo de campos principal.)
"/properties/_{TENANT_ID}/properties/loyaltyLevel" (Retorna uma referência à variável loyaltyLevel , fornecido por um grupo de campos personalizado.)
"/properties/_{TENANT_ID}/properties/loyaltyLevel/enum" ["platinum", "gold", "silver", "bronze"]
"/properties/_{TENANT_ID}/properties/loyaltyLevel/enum/0" "platinum"
OBSERVAÇÃO

Ao lidar com o xdm:sourceProperty e xdm:destinationProperty atributos de Experience Data Model (XDM) descritores, quaisquer properties as chaves devem ser excluídos na string JSON Pointer . Consulte a Schema Registry Subguia do guia do desenvolvedor de API em descritores para obter mais informações.

Patch JSON

Há muitas operações do PATCH para Platform APIs que aceitam objetos de patch JSON para suas cargas de solicitação. O Patch JSON é um formato padronizado (RFC 6902) para descrever alterações em um documento JSON. Ela permite definir atualizações parciais para o JSON sem precisar enviar o documento inteiro em um corpo da solicitação.

Exemplo de objeto de patch JSON

{
  "op": "remove",
  "path": "/foo"
}
  • op: O tipo de operação de patch. Embora o Patch JSON seja compatível com vários tipos de operação diferentes, nem todas as operações de PATCH em Platform As APIs são compatíveis com cada tipo de operação. Os tipos de operação disponíveis são:
    • add
    • remove
    • replace
    • copy
    • move
    • test
  • path: A parte da estrutura JSON a ser atualizada, identificada usando Ponteiro JSON notação.

Dependendo do tipo de operação indicado em op, o objeto Patch JSON pode exigir propriedades adicionais. Para obter mais informações sobre as diferentes operações de Patch JSON e sua sintaxe necessária, consulte o Documentação do patch JSON.

Esquema JSON

Esquema JSON é um formato usado para descrever e validar a estrutura dos dados JSON. Experience Data Model (XDM) usam os recursos do Esquema JSON para impor restrições na estrutura e no formato dos dados de experiência do cliente assimilados. Para obter mais informações sobre o Esquema JSON, consulte documentação oficial.

Próximas etapas

Este documento apresentou algumas tecnologias e sintaxes envolvidas no gerenciamento de recursos baseados em JSON para Experience Platform. Consulte a guia de introdução para obter mais informações sobre como trabalhar com APIs da plataforma, incluindo práticas recomendadas. Para obter respostas para perguntas frequentes, consulte o Guia de solução de problemas da plataforma.

Nesta página