DocumentatieExperience PlatformHandleiding voor Privacy Service

Inhoudseindpunt

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Gebruik het /content eindpunt om toegangsinformatie veilig terug te winnen (de informatie die een privacyonderwerp kan met recht verzoeken om toegang) voor uw klanten. De download-URL in het antwoord op een /jobs/{JOB_ID} GET-aanvraag verwijst naar een Adobe-servicedetail. U kunt vervolgens een GET-aanvraag indienen bij /jobs/:JOB_ID/content om uw klantgegevens in JSON-indeling te retourneren. Deze toegangsmethode voert veelvoudige lagen van authentificatie en toegangsbeheer uit om veiligheid te verbeteren.

Alvorens deze gids te gebruiken, gelieve te verwijzen naar ​ begonnen gids ​ voor informatie over de vereiste authentificatiekopballen die in de voorbeeld API hieronder vraag worden voorgesteld.

TIP
Als u momenteel niet baanidentiteitskaart voor de toegangsinformatie kent u vereist, maak een vraag aan het /jobs eindpunt en gebruik extra vraagparameters om de resultaten te filtreren. Een volledige lijst van de beschikbare vraagparameters kan in de ​ gids van het de baaneindpunt van de privacy ​ worden gevonden.

Taakgegevens over privacy ophalen

Als u informatie wilt ophalen over een specifieke taak, zoals de huidige verwerkingsstatus, neemt u de taak jobId op in het pad van een GET-aanvraag naar het /jobs -eindpunt.

API formaat

GET /jobs/{JOB_ID}

Verzoek

Met het volgende verzoek worden de details opgehaald van de taak waarvan jobId is opgegeven in het aanvraagpad.

curl -X GET \
  https://platform.adobe.io/data/core/privacy/jobs/dbe3a6a6-f8e6-11ee-a365-8d1d6df81cc5 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}'

Reactie

Een geslaagde reactie retourneert de details van de opgegeven taak.

NOTE
Privacy-taken moeten de complete -status hebben om de downloadUrl te bevatten.
{
    "jobId":"dbe3a6a6-f8e6-11ee-a365-8d1d6df81cc5",
    "requestId":"17129380910360540RX-753",
    "userKey":"1234",
    "action":"access",
    "status":"complete",
    "submittedBy":"jsnow@adobe.com",
    "createdDate":"04/12/2024 04:08 PM GMT",
    "lastModifiedDate":"04/12/2024 04:08 PM GMT",
    "userIds":[{
        "namespace":"ECID",
        "value":"1234",
        "type":"standard",
        "namespaceId":4,
        "isDeletedClientSide":false
        }],
    "productResponses":[{
        "product":"Identity",
        "retryCount":0,
        "processedDate":"04/12/2024 04:08 PM GMT",
        "productStatusResponse":{"status":"submitted"
        }}],
    "downloadUrl":"https://platform.adobe.io/data/core/privacy/jobs/dbe3a6a6-f8e6-11ee-a365-8d1d6df81cc5/content",
    "regulation":"gdpr"
}
Eigenschap
Beschrijving
jobId
Een unieke id voor de privacytaak.
requestId
Een unieke identificatiecode voor het specifieke verzoek dat aan de Privacy Service wordt gedaan.
userKey
userKey is de key -waarde die u hebt opgegeven toen u de privacyaanvraag indiende. De waarde key is uw gelegenheid om een id voor de betrokkene te verstrekken die voor u zinvol is. Het is doorgaans een unieke id die uw systeem heeft gemaakt voor het bijhouden van die gegevens. TIP: U kunt alle actieve privacytaken weergeven en de key met elke taak vergelijken.
action
Het gevraagde type actie. De toegestane waarden zijn access en delete .
status
De huidige status van de privacytaak.
submittedBy
Het e-mailadres van de persoon die de privacytaak heeft ingediend.
createdDate
De datum en tijd waarop de privacytaak is gemaakt.
lastModifiedDate
De datum en tijd waarop de privacytaak voor het laatst is gewijzigd.
userIds
Een array met gebruikers-id's en verwante informatie.
userIds.namespace
De naamruimte die voor de gebruikersnaam wordt gebruikt.
userIds.value
De werkelijke waarde van de gebruikersidentificatie.
userIds.type
Het type id (bijvoorbeeld standard of custom).
userIds.namespaceId
Een id voor de naamruimte die wordt gebruikt om gebruikersidentiteiten te categoriseren en te beheren.
userIds.isDeletedClientSide
Een Booleaanse waarde die aangeeft of de id aan de clientzijde is verwijderd.
productResponses
Een array met reacties van verschillende producten of services met betrekking tot de privacytaak.
productResponses.product
De naam van het product of de dienst die is gebruikt om informatie over de betrokkene te verkrijgen.
productResponses.retryCount
Het aantal keren dat de aanvraag opnieuw is geprobeerd.
productResponses.processedDate
De datum en het tijdstip waarop de reactie van het product is verwerkt.
productResponses.productStatusResponse
Een object dat de status van de reactie van het product bevat.
productResponses.productStatusResponse.status
De status van de respons van het product.
downloadURL
Deze eigenschap verstrekt een eindpunt, dat beschikbaar is om 60 dagen te roepen nadat de baan voltooit. De status van de taak moet complete zijn en action moet access zijn. Anders is dit veld niet aanwezig.
regulation
Het regelgevingskader waaronder de privacyaanvraag wordt verwerkt, zoals gdpr , ccpa , lgpd_bra , pdpa_tha , enzovoort.

De informatie van de klantentoegang terugwinnen retrieve-access-data

Om de "toegangsinformatie"te krijgen die in antwoord op de vraag van uw gegevenssubject wordt geproduceerd, doe een verzoek van de GET aan het /jobs/{JOB_ID}/content eindpunt. De reactie is een ZIP-bestand (*.zip) dat een map bevat met submappen voor elk product dat gegevens over de betrokkene bevat.

TIP
U hebt een specifieke taak-id nodig om deze aanvraag in te dienen. Als u de specifieke baan ID moet terugwinnen, doe eerst een verzoek van de GET aan het /jobs eindpunt en gebruik extra vraagparameters om de resultaten te filtreren. De gedetailleerde informatie met inbegrip van de toegestane vraagparameters kan in de ​ gids van het de baaneindpunt van de privacy ​ worden gevonden.

API formaat

GET /jobs/{JOB_ID}/content

Verzoek

Het volgende verzoek retourneert 'toegangsinformatie' voor de taak-id die in het verzoek wordt opgegeven.

curl -X GET \
  https://platform.adobe.io/data/core/privacy/jobs/32d429b1-f7f4-11ee-a365-574bcf5a525d/content \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Accept: application/json`

Reactie

De reactie is een ZIP-bestand (*.zip). De informatie wordt doorgaans geretourneerd in JSON-indeling, maar dat kan niet worden gegarandeerd. Geëxtraheerde gegevens kunnen in elke indeling worden geretourneerd.

recommendation-more-help
9cbf7061-a312-49f7-aaf8-a10885d53580