Show Menu
ARGOMENTI×

Nozioni di base sulle API Adobe Experience Platform

Le API di Adobe Experience Platform utilizzano diverse tecnologie e sintassi di base importanti per gestire efficacemente le risorse basate su JSON Platform . Il presente documento fornisce una breve panoramica di queste tecnologie e collegamenti alla documentazione esterna per ulteriori informazioni.

Puntatore JSON

JSON Pointer è una sintassi di stringa standard ( RFC 6901 ) per identificare valori specifici all'interno dei documenti JSON. Un puntatore JSON è una stringa di token separati da / caratteri, che specificano le chiavi oggetto o gli indici di array e i token possono essere una stringa o un numero. Le stringhe Puntatore JSON vengono utilizzate in molte operazioni PATCH per Platform le API, come descritto più avanti in questo documento. Per maggiori informazioni su JSON Pointer, consulta la documentazione sulla panoramica di JSON Pointer.

Esempio di oggetto schema JSON

{
    "type": "object",
    "title": "Loyalty Member Details",
    "meta:intendedToExtend": [
        "https://ns.adobe.com/xdm/context/profile"
    ],
    "description": "Loyalty Program Mixin.",
    "definitions": {
        "loyalty": {
            "properties": {
                "_{TENANT_ID}": {
                    "type": "object",
                    "properties": {
                        "loyaltyId": {
                            "title": "Loyalty Identifier",
                            "type": "string",
                            "description": "Loyalty Identifier.",
                            "meta:xdmType": "string"
                        },
                        "loyaltyLevel": {
                            "title": "Loyalty Level",
                            "description": "The current loyalty program level to which the individual member belongs.",
                            "type": "string",
                            "enum": [
                                "platinum",
                                "gold",
                                "silver",
                                "bronze"
                            ],
                            "meta:enum": {
                                "platinum": "Platinum",
                                "gold": "Gold",
                                "silver": "Silver",
                                "bronze": "Bronze"
                            },
                            "meta:xdmType": "string"
                        }
                    },
                    "meta:xdmType": "object"
                }
            },
            "type": "object",
            "meta:xdmType": "object"
        }
    }
}

Esempio di puntatori JSON basati sull'oggetto schema

Puntatore JSON
Risolve a
"/title"
"Dettagli membro fedeltà"
"/definitions/loyalty"
(Restituisce il contenuto dell' loyalty oggetto)
"/definitions/loyalty/properties/_{TENANT_ID}/properties/loyaltyLevel/enum"
["platinum", "gold", "silver", "bronze"]
"/definitions/loyalty/properties/_{TENANT_ID}/properties/loyaltyLevel/enum/0"
"platinum"
Quando si utilizzano gli xdm:sourceProperty attributi e xdm:destinationProperty gli attributi dei descrittori Experience Data Model (XDM), qualsiasi properties chiave deve essere esclusa dalla stringa Puntatore JSON. Per ulteriori informazioni, consulta la guida per gli sviluppatori di Schema Registry API in descrittori .

Patch JSON

Esistono molte operazioni PATCH per Platform le API che accettano oggetti JSON Patch per i payload di richiesta. La patch JSON è un formato standard ( RFC 6902 ) per descrivere le modifiche a un documento JSON. Consente di definire aggiornamenti parziali a JSON senza dover inviare l’intero documento in un corpo della richiesta.

Esempio di oggetto patch JSON

{
  "op": "remove",
  "path": "/foo"
}

  • op : Tipo di operazione della patch. Sebbene la patch JSON supporti diversi tipi di operazioni, non tutte le operazioni PATCH nelle Platform API sono compatibili con ogni tipo di operazione. I tipi di operazioni disponibili sono:
    • add
    • remove
    • replace
    • copy
    • move
    • test
  • path : La parte della struttura JSON da aggiornare, identificata utilizzando la notazione JSON Pointer .
A seconda del tipo di operazione indicato in op , l'oggetto Patch JSON potrebbe richiedere proprietà aggiuntive. Per ulteriori informazioni sulle diverse operazioni di patch JSON e sulla relativa sintassi richiesta, consulta la documentazione relativa alla patch JSON.

Schema JSON

Lo schema JSON è un formato utilizzato per descrivere e convalidare la struttura dei dati JSON. Experience Data Model (XDM) sfrutta le funzionalità dello schema JSON per applicare vincoli alla struttura e al formato dei dati esperienza cliente acquisiti. Per ulteriori informazioni sullo schema JSON, consulta la documentazione ufficiale.

Passaggi successivi

In questo documento sono state introdotte alcune tecnologie e sintassi relative alla gestione delle risorse basate su JSON per Experience Platform. Per ulteriori informazioni sull'utilizzo delle Platform API, comprese le procedure ottimali e le risposte alle domande frequenti, consultate la guida alla risoluzione dei problemi della piattaforma .