Aprenda a utilizar la API Singular para dar soporte a las solicitudes GDPR.

Para saber cómo encajan las solicitudes de los titulares de los datos en una arquitectura de consentimiento más amplia, y por qué el borrado no es lo mismo que detener el seguimiento, consulta Consent Management with the Singular SDK: A Decision Framework.

Puntos finales GDPR

Punto final de descubrimiento

Uso

El punto final OpenGDPR Discovery devuelve todos los tipos de solicitud admitidos actualmente que Singular puede procesar a través de la API GDPR.

Ejemplo de consulta

import requests
  response = requests.get("https://gdpr.singular.net/api/gdpr/discovery")
  print(response.text)

Ejemplo de salida

{
    "api_version": "0.1.4",
    "supported_identities": [
      {"identity_format": "raw","identity_type": "android_advertising_id"},
      {"identity_format": "raw","identity_type": "android_id"},
      {"identity_format": "raw","identity_type": "ios_advertising_id"},
      {"identity_format": "raw","identity_type": "ios_vendor_id"},
      {"identity_format": "raw","identity_type": "user_id"}
    ],
    "supported_subject_request_types": [
        "erasure",
        "access"
    ]
  }

Punto final de solicitudes

Uso

El punto final OpenGDPR Requests gestiona nuevas solicitudes GDPR, enviadas a través de una solicitud HTTP POST mientras se especifican los ID de dispositivo para los sujetos de datos solicitados.

Solicitudes admitidas

El endpoint OpenGDPR Requests admite los siguientes tipos de solicitudes, correspondientes a diferentes derechos GDPR:

• `erasure` - solicitudes de eliminación de datos como parte del artículo 17 del GDPR, Derecho a la eliminación
• `access` - solicitudes de acceso a los datos en virtud del artículo 15 del RGPD, Derecho de acceso.

ID compatibles

El punto final OpenGDPR Requests admite los siguientes tipos de ID:

• `android_advertising_id` - solicitudes realizadas proporcionando el ID de publicidad de Google, también conocido como GAID o AIFA
• `android_id` - solicitudes realizadas proporcionando el ID de Android, también conocido como ANDI
• `ios_advertising_id` - solicitudes realizadas proporcionando el IDFA, que es el ID de publicidad de iOS
• `ios_vendor_id` - solicitudes realizadas proporcionando IDFV, que es el ID de iOS para proveedores
• `user_id` - solicitudes realizadas proporcionando el ID de usuario personalizado

Ejemplo de consulta

import requests
  
  url = "https://gdpr.singular.net/api/gdpr/requests"
  
  payload = {
    "subject_request_id": "1c8b23f4-12eb-4fe8-af1c-0f72807dfec2",
    "subject_request_type": "access",
    "submitted_time": "2018-05-25T10:00:00Z",
    "subject_identities": [
      {
        "identity_type": "android_advertising_id",
        "identity_value": "38400000-8cf0-11bd-b23e-10b96e40000d",
        "identity_format": "raw"
      }
    ],
    "property_id": "Android:com.myapp.xyz",
  }
  
  headers = {
    "content-type": "application/json",
    "Authorization": "[API_KEY]"
  }
  
  response = requests.post(url, json=payload, headers=headers)
  print(response.text)

Parámetros de consulta

[
  {
    "identity_type":
    "android_advertising_id",
    "identity_value": 
    "38400-8cf0-11bd-b23e-1000d",
    "identity_format": "raw"
  }
  ]

Ejemplo de salida

{
    "controller_id":"example_controller_id",
    "received_time":"2018-05-25T10:00:01Z",
    "expected_completion_time": "2018-06-24T10:00:01Z",
    "encoded_request":"<BASE64 ENCODED REQUEST>",
    "subject_request_id":"1c8b23f4-12eb-4fe8-af1c-0f72807dfec2",
    "results_url": "https://url-to-results-in-json-format",
    "api_version": "0.1.4"
  }

Alcance de la eliminación

El borrado elimina los registros a nivel de usuario (logs y detalle de atribución) que Singular conserva para el identificador. Los datos agregados (por ejemplo, los resúmenes de cohortes) no son direccionables por dispositivo una vez agregados y no se ven afectados por el borrado. Describe esta distinción en tu propia documentación de privacidad.

Estado del punto final

Uso

Devuelve el estado actual de una solicitud enviada previamente, identificada por su ID de solicitud.

Ejemplo de consulta

import requests
  url = "https://gdpr.singular.net/api/gdpr/requests/"
  subject_request_id = "1c8b23f4-12eb-4fe8-af1c-0f72807dfec2"
  headers = {"Authorization": "<API KEY>"}
  response = requests.get(url+subject_request_id, headers=headers)
  print(response.text)

Ejemplo de salida

{
      "controller_id": "example_controller_id",
      "request_status": "completed",
      "expected_completion_time": "2018-06-24T10:00:01Z",
      "subject_request_id": "1c8b23f4-12eb-4fe8-af1c-0f72807dfec2",
      "api_version": "0.1.4"
  }

Punto final de cancelación

Uso

Utilice este punto final para cancelar una solicitud anterior. Esto es posible siempre que la solicitud se encuentre en estado "pendiente".

Ejemplo de consulta

import requests
  url = "https://gdpr.singular.net/api/gdpr/requests/"
  subject_request_id = "1c8b23f4-12eb-4fe8-af1c-0f72807dfec2"
  headers = {"Authorization": "<API KEY>"}
  response = requests.delete(url+subject_request_id, headers=headers)
  print(response.text)

Ejemplo de salida

{
    "controller_id":"example_controller_id",
    "subject_request_id":"1c8b23f4-12eb-4fe8-af1c-0f72807dfec2",
    "received_time":"2018-05-25T10:00:01Z",
    "api_version":"0.1"
  }