Guida dell’API di igiene dei dati
L’API di igiene dei dati consente di correggere o eliminare in modo programmatico i dati personali memorizzati dai clienti in Adobe Experience Platform, nonché di pianificare le date di scadenza dei set di dati. Questa guida descrive i passaggi preliminari per l’utilizzo dell’API e fornisce collegamenti a documentazione più specifica per l’endpoint.
Introduzione
È possibile accedere all'API di igiene dei dati tramite il seguente percorso principale: https://platform.adobe.io/data/core/hygiene/
Le sezioni seguenti descrivono i concetti di base che devi conoscere prima di tentare di effettuare chiamate all’API.
Raccogliere i valori per le intestazioni richieste
Per effettuare chiamate all’API di igiene dei dati, devi prima raccogliere le credenziali di autenticazione. Segui la guida all'autenticazione API per generare i valori per ciascuna delle intestazioni richieste per l'API di igiene dei dati, come illustrato di seguito:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Tutte le richieste che contengono un payload (POST, PUT, PATCH) richiedono un’intestazione aggiuntiva:
Content-Type: application/json
Lettura delle chiamate API di esempio
Questo documento fornisce un esempio di chiamata API per dimostrare come formattare le richieste. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consulta la sezione su come leggere le chiamate API di esempio nella guida introduttiva per le API di Experience Platform.
Scadenze dei set di dati
La scadenza di un set di dati è un’azione "elimina un set di dati" posticipata nel tempo. Creando una scadenza del set di dati, si specifica un momento futuro in cui tale set di dati deve essere eliminato. Consulta la guida dell'endpoint di scadenza del set di dati per informazioni dettagliate sulla pianificazione delle scadenze dei set di dati nell'API.
Eliminazioni record
L’API di igiene dei dati consente di eliminare tutti i record associati a un’identità in uno o tutti i set di dati. Tutte le attività del ciclo di vita dei dati che eliminano le identità sono rappresentate da un costrutto chiamato ordine di lavoro. Per informazioni dettagliate sull'utilizzo delle eliminazioni di record nell'API, consulta la guida dell'endpoint dell'ordine di lavoro.
Quota
L'organizzazione è limitata a una quota mensile predeterminata di processi per ogni tipo di operazione del ciclo di vita dei dati, che può variare a seconda della licenza. Consulta la guida dell'endpoint quota per informazioni dettagliate sulla visualizzazione dello stato attuale della quota dei processi del ciclo di vita dei dati.
Passaggi successivi
Questa guida illustra come gestire le richieste del ciclo di vita dei dati utilizzando le chiamate API. Per informazioni su come eseguire queste azioni nell'interfaccia utente di Platform, consulta la guida dell'interfaccia utente del ciclo di vita dei dati.