Aspectos básicos de la API del Experience Platform

Las API de Adobe Experience Platform emplean varias tecnologías subyacentes y sintaxis que son importantes de comprender para administrar de forma eficaz los recursos basados en JSON Platform. Este documento proporciona una breve descripción general de estas tecnologías, así como enlaces a documentación externa para obtener más información.

Puntero JSON

El puntero JSON es una sintaxis de cadena estandarizada (RFC 6901) para identificar valores específicos dentro de documentos JSON. Un puntero JSON es una cadena de tokens separados por caracteres /, que especifican claves de objeto o índices de matriz, y los tokens pueden ser una cadena o un número. Las cadenas de puntero JSON se utilizan en muchas operaciones de PATCH para API Platform, tal como se describe más adelante en este documento. Para obtener más información sobre el puntero JSON, consulte la documentación general del puntero JSON.

Ejemplo de objeto de esquema JSON

El siguiente JSON representa un esquema XDM simplificado cuyos campos pueden ser referenciados usando cadenas de puntero JSON. Tenga en cuenta que todos los campos que se han agregado utilizando mezclas personalizadas (como loyaltyLevel) tienen un espacio de nombres dentro de un objeto _{TENANT_ID}, mientras que los campos que se han agregado utilizando mezclas principales (como fullName) no lo son.

{
  "$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"
        }
      }
    }
  }
}

Ejemplo de punteros JSON basados en el objeto de esquema

Puntero JSON Resuelve como
"/title" "Example schema"
"/properties/person/properties/name/properties/fullName" (Devuelve una referencia al campo fullName, proporcionado por una mezcla de núcleo).
"/properties/_{TENANT_ID}/properties/loyaltyLevel" (Devuelve una referencia al campo loyaltyLevel, proporcionado por una mezcla personalizada).
"/properties/_{TENANT_ID}/properties/loyaltyLevel/enum" ["platinum", "gold", "silver", "bronze"]
"/properties/_{TENANT_ID}/properties/loyaltyLevel/enum/0" "platinum"
NOTA

Al tratar con los atributos xdm:sourceProperty y xdm:destinationProperty de los descriptores Experience Data Model (XDM), cualquier clave properties debe estar excluida de la cadena del puntero JSON. Consulte la Schema Registry guía para desarrolladores de API en la subguía descriptors para obtener más información.

Parche JSON

Existen muchas operaciones de PATCH para las API Platform que aceptan objetos JSON Patch para sus cargas de solicitud. JSON Patch es un formato estandarizado (RFC 6902) para describir los cambios realizados en un documento JSON. Le permite definir actualizaciones parciales a JSON sin necesidad de enviar el documento completo en un cuerpo de solicitud.

Ejemplo de objeto JSON Patch

{
  "op": "remove",
  "path": "/foo"
}
  • op: Tipo de operación de parche. Aunque JSON Patch admite varios tipos de operación diferentes, no todas las operaciones de PATCH en las API Platform son compatibles con todos los tipos de operación. Los tipos de operación disponibles son:
    • add
    • remove
    • replace
    • copy
    • move
    • test
  • path: Parte de la estructura JSON que se va a actualizar e identificar mediante la anotación JSON.

Según el tipo de operación indicado en op, el objeto JSON Patch puede requerir propiedades adicionales. Para obtener más información sobre las distintas operaciones de parches JSON y su sintaxis requerida, consulte la documentación de parches JSON.

Esquema JSON

El esquema JSON es un formato utilizado para describir y validar la estructura de los datos JSON. Experience Data Model (XDM) aprovecha las capacidades del esquema JSON para imponer restricciones en la estructura y el formato de los datos de experiencia del cliente ingestados. Para obtener más información sobre el esquema JSON, consulte la documentación oficial.

Pasos siguientes

Este documento introdujo algunas de las tecnologías y sintaxis involucradas en la administración de recursos basados en JSON para Experience Platform. Consulte la guía de introducción para obtener más información sobre cómo trabajar con las API de Platform, incluidas las prácticas recomendadas. Para obtener respuestas a las preguntas más frecuentes, consulte la Guía de solución de problemas de Platform.

En esta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
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