Info
Contenido

API de datos

La API de datos permite descargar datos sin procesar del sistema. La API de datos se puede encontrar en el punto final

https://app.consentmanager.net/api/data.php

Obtener datos

Para obtener los datos de sus CMP, envíe un HTTP GET a la API de datos con los siguientes parámetros:

Parámetro

Descripción

Ejemplo

clave

Clave de autenticación

jf892rt

en

Fecha de inicio

1983-07-15

a

Fecha de finalización

2018-08-02

tipo

Tipo de datos:

·         1 = informe CMP

·         2 = Informe de publicadores (ya no es compatible)

· 3 = Informe del rastreador

·         4 = Registro de consentimiento

· 5 = Lista CMP

· 6 = Lista de diseños

· 7 = Lista de dominios (cookies)

· 8 = Versiones de texto

· 9 = Lista de proveedores personalizada

· 10 = Lista de propósitos personalizados

· 11 = Lista de SO

· 12 = Lista del navegador

· 13 = Lista de dispositivos

· 14 = Lista de tipos de consentimiento

· 15 = ID de último rastreo

· 16 = (entrega CMP) Lista de dominios

· 17 = Subcuentas

· 18 = Registro de cambios

· 19 = Registro de consentimiento

1

salida

csv o json

json

todos

0 o 1. Solo válido para tipo = 9

1

Resultado

La API devolverá el siguiente objeto:

{ 
  "status":"created", //status, always “created” 
  "message": "Data report created", //status message 
  "data": "…" //data payload as csv or json format
}

Importante: Tenga en cuenta que el formato de salida de la carga útil de datos puede cambiar de vez en cuando (por ejemplo, se agregan nuevas columnas, se eliminan columnas, se cambian columnas). Al diseñar su software, siga los pasos necesarios para detectar cambios en la estructura de datos.

Ejemplos

Informe CMP (tipo = 1)

{
  "status":"created",
  "message":"Data report created",
  "data": [ 
    {
      "cmpID":"3",
      "designID":"13",
      "country":"DE",
      "date":"2019-05-27",
      "hour":"23",
      "urlID":"123",
      "osID":"2",
      "uaID":"4",
      "deviceID":"2",
      "pageView":"3",
      "consentView":"0",
      "consentAccept":"0",
      "consentReject":"0",
      ...
    }, ...
   ]
}  

Informe de publicadores (tipo = 2)

Ya no es compatible.

Informe de rastreador (tipo = 3)

{
  "status":"created",
  "message":"Data report created",
  "data":[
    {"cmpID":"4",
     "date":"2019-05-22",
     "hour":"21",
     "crawls":"8",
     "cookiesFound":"564",
     "cookiesNew":"10",
     "domainsFound":"431",
     "domainsNew":"1"
    }, ...
  ]
}

Ya no es compatible. Utilice type = 19 en su lugar.

Lista de CMP (tipo = 5)

{
  "status":"created",
  "message":"Data report created",
  "data":[
    {
      "id":"3",
      "name":"My CMP",
      "status":"1"
    }, ...
  ]
}

Lista de diseño (tipo = 6)

{
  "status":"created",
  "message":"Data report created",
  "data":[
    {
      "id":"1",
      "name":"[Default]\/Bottom right",
      "status":"1",
      "defaultDesign":"1"
    }, ...
  ]
}    

(Cookie) Lista de dominios (tipo = 7)

{
  "status":"created",
  "message":"Data report created",
  "data":[
    {
      "id":"1",
      "domain":"example.com"
    }, ...
  ]
}    

Versiones de texto (tipo = 8)

Nota: La API proporcionará los textos predeterminados para todos los idiomas como id = 0.

{
  "status":"created",
  "message":"Data report created",
  "data":[
   {
     "id":0,
     "design":0,
     "date":null,
     "lang":"EN",
     "jsonText":
     {
       "cc":"en",
       "load":"Loading",
       "hl":"We value your privacy!",
       "txt":"...",...
     }
   }, ...
  ]
}

Lista de proveedores personalizados (tipo = 9)

Nota: Si se establece el parámetro & all = 1, la API informará todos los proveedores personalizados y de sistemas que se creen. Si el parámetro no se establece o se establece en 0 (cero), la API solo informará a los proveedores que están actualmente en uso para cualquiera de sus CMP.

{
  "status":"created",
  "message":"Data report created",
  "data":[
    {
      "id":"c24",
      "cmp":"3",
      "name":"Google Ads",
      "link":"https:\/\/policies.google.com\/privacy?hl=en&gl=ZZ",
      "logo":"\/delivery\/icons_c24.ico"
    }, ...
  ]
}

Lista de propósitos personalizados (tipo = 10)

{
  "status":"created",
  "message":"Data report created",
  "data":[
    {
      "id":"1",
      "cmp":"3",
      "name":"My Purpose",
      "description":"..."
    }, ...
  ]
}

Lista de SO (tipo = 11)

{
  "status":"created",
  "message":"Data report created",
  "data":[
    {
      "id":0,
      "name":"unknown"
    },
    {
      "id":2,
      "name":"Windows"
    }, ...
  ]
}

Lista del navegador (tipo = 12)

{
  "status":"created",
  "message":"Data report created",
  "data":[
    {
      "id":0,
      "name":"unknown"
    },
    {
      "id":16,
      "name":"Google Chrome"
    }, ...
  ]
}

Lista de dispositivos (tipo = 13)

{
  "status":"created",
  "message":"Data report created",
  "data":[
    {
      "id":0,
      "name":"unknown"
    },
    {
      "id":2,
      "name":"Desktop"
    },...
  ]
}
{
  "status":"created",
  "message":"Data report created",
  "data":[
    {
      "id":0,
      "name":"unknown"
    },
    {
      "id":1,
      "name":"Button click: Accept all"
    }, ... 
  ]
}

Últimos ID de rastreo (tipo = 15)

{
  "status":"created",
  "message":"Data report created",
  "data":[
    {
      "id":"23380",
      "url":"https:\/\/www....",
      "startDate":"2019-05-25 21:04:22",
      "risk":"100"
    }, ...
  ]
}

(Entrega CMP) Lista de dominios (tipo = 16)

Utilice el parámetro & domainid = X para consultar un ID de dominio específico. De lo contrario, la lista mostrará los ID que se han utilizado en este rango de fechas (por ejemplo, hoy).

{
  "status":"created",
  "message":"Data report created",
  "data":[
    {
      "id":"1",
      "domain":"example.com"
    }, ...
  ]
}    

Subcuentas (tipo = 17)

{
  "status":"created",
  "message":"Data report created",
  "data":[
    {
      "id":"3",
      "login":"...",
      "mail":"...",
      "rights":"cmp;designs;texts;...",
      "restrictCMP":"0",
      "allowedCMP":"3;4",
      "status":"1",
      "lastLogin":"2019-07-27 17:32:53"
    }, ...
  ]
}

Registro de cambios (tipo = 18)

{
  "status":"created",
  "message":"Data report created",
  "data":[
    {
      "id":"820",
      "datatype":"designs",
      "changetype":"1",
      "itemID":"11",
      "userID":"1",
      "subaccountID":"-1",
      "accountID":"0",
      "changedate":"2019-07-27 18:36:40",
      "oldData":{...},
      "newData":{...}
    }, ...
  ]
}

Este tipo se puede utilizar para recuperar el registro de consentimiento (protocolo) de una cuenta. Nota: Los protocolos se envían para archivar después de 7 días y ya no se pueden descargar a través de la API.

Volver