Gestione Consensi e Privacy


Lista Informative Privacy

Restituisce la lista delle Informative Privacy dell'utente.

URI

GET https://api.smshosting.it/rest/api/gdpr/privacy/list


Richiesta

ParametroObbligatorioTipoDescrizione
only_visibleNoBooleanIndica se restituire solo le Informative Privacy attualmente visibili o meno.

Risposta

HTTP Status Code

CodiceDescrizione
200 ok
401 Credenziali non valide
405 Metodo HTTP non consentito
500 Errore generico

 Esempio:

   curl --user AUTH_KEY:AUTH_SECRET \
   -XGET https://api.smshosting.it/rest/api/gdpr/privacy/list
{
    "privacyList": [
        {
            "id": 4601,
            "privacySource": "URL",
            "privacyValue": "https://www.myPrivacyURL/",
            "vers": "Privacy URL",
            "insertDate": "2020-10-13T08:14:07+0200",
            "visible": true
        },
        {
            "id": 4326,
            "privacySource": "TEXT",
            "privacyValue": "....",
            "vers": "3",
            "insertDate": "2019-08-01T10:43:19+0200",
            "visible": false
        }
    ]
}

Lista Consensi GDPR

Restituisce la lista dei consensi GDPR dell'utente.

URI

GET https://api.smshosting.it/rest/api/gdpr/consent/list


Richiesta

ParametroObbligatorioTipoDescrizione
only_visibleNoBooleanIndica se restituire solo i consensi GDPR attualmente visibili o meno.

Risposta

HTTP Status Code

CodiceDescrizione
200 ok
401 Credenziali non valide
405 Metodo HTTP non consentito
500 Errore generico

 Esempio:

   curl --user AUTH_KEY:AUTH_SECRET \
   -XGET https://api.smshosting.it/rest/api/gdpr/consent/list
{
    "consentList": [
        {
            "id": 7687,
            "title": "Consenso Terze parti",
            "category": "THIRDPARTIES",
            "description": "Do il consenso per le comunicazioni a terzi",
            "insertDate": "2019-03-21T08:39:01+0100",
            "visible": false
        },
        {
            "id": 11782,
            "title": "Consenso Profilazione",
            "category": "PROFILING",
            "description": "Do il consenso al trattamento dei dati per attività di profilazione",
            "insertDate": "2019-03-21T08:39:01+0100",
            "visible": true
        },
        {
            "id": 3592,
            "title": "Consenso Marketing",
            "category": "MARKETING",
            "description": "Do il consenso a ricevere comunicazioni, sconti e promozioni tramite SMS e email",
            "insertDate": "2019-03-21T08:38:57+0100",
            "visible": false
        }
    ]
}

Storico Consensi GDPR Contatto

Restituisce lo storico dei consensi GDPR accettati o rifiutati dal contatto

URI

GET https://api.smshosting.it/rest/api/gdpr/history/contact/{id_contatto}


Richiesta

ParametroObbligatorioTipoDescrizione
id_contattoSi (Parametro da specificare nell' URI)IntegerSpecificare l'ID del contatto di cui si desidera ricevere lo storico.

Risposta

HTTP Status Code

CodiceDescrizione
200 ok
400

Parametri non validi, i possibili valori sono:

CONTACT_NOT_EXISTS - L'ID del contatto è errato

401 Credenziali non valide
405 Metodo HTTP non consentito
500 Errore generico

 Esempio:

   curl --user AUTH_KEY:AUTH_SECRET \
   -XGET https://api.smshosting.it/rest/api/gdpr/history/contact/12345
{
    "gdprContactInfo": [
        {
            "consent_type": "PRIVACY",
            "consent_id": 4601,
            "granted": true,
            "insert_date": "2020-10-13T08:15:21+0200",
            "ip": "0:0:0:0:0:0:0:1",
            "source": "api",
            "consent_title": "Privacy URL"
        },
        {
            "consent_type": "PRIVACY",
            "consent_id": 4326,
            "granted": false,
            "insert_date": "2020-10-13T08:08:10+0200",
            "ip": "0:0:0:0:0:0:0:1",
            "source": "api",
            "consent_title": "Privacy"
        },
        {
            "consent_type": "CONSENT",
            "consent_id": 7687,
            "granted": false,
            "insert_date": "2020-10-12T16:25:53+0200",
            "ip": "0:0:0:0:0:0:0:1",
            "source": "api",
            "consent_title": "Do il consenso per le comunicazioni a terzi"
        }
    ]
}

Consensi GDPR Contatto

Restituisce lo stato attuale dei consensi GDPR accettati o rifiutati dal contatto

URI

GET https://api.smshosting.it/rest/api/gdpr/contact/{id_contatto}


Richiesta

ParametroObbligatorioTipoDescrizione
id_contattoSi (Parametro da specificare nell' URI)IntegerSpecificare l'ID del contatto di cui si desidera ricevere i dati.

Risposta

HTTP Status Code

CodiceDescrizione
200 ok
400

Parametri non validi, i possibili valori sono:

CONTACT_NOT_EXISTS - L'ID del contatto è errato

401 Credenziali non valide
405 Metodo HTTP non consentito
500 Errore generico

 Esempio:

   curl --user AUTH_KEY:AUTH_SECRET \
   -XGET https://api.smshosting.it/rest/api/gdpr/contact/12345
{
    "gdprContactInfo": [
        {
            "consent_type": "PRIVACY",
            "consent_id": 4601,
            "granted": true,
            "insert_date": "2020-10-13T08:15:21+0200",
            "ip": "0:0:0:0:0:0:0:1",
            "source": "api",
            "consent_title": "Privacy URL"
        },
        {
            "consent_type": "CONSENT",
            "consent_id": 7687,
            "granted": false,
            "insert_date": "2020-10-12T16:25:53+0200",
            "ip": "0:0:0:0:0:0:0:1",
            "source": "api",
            "consent_title": "Do il consenso per le comunicazioni a terzi"
        }
    ]
}

Aggiunta Consenso GDPR Contatto

Aggiunge un consenso GDPR a un contatto

URI

POST https://api.smshosting.it/rest/api/gdpr/contact/add/{type}/{id_contatto}


Richiesta

ParametroObbligatorioTipoDescrizione
type Si (Parametro da specificare nell' URI) String Specificare il tipo di consenso che si vuole aggiungere
Possbili valori: privacy, consent
id_contatto Si (Parametro da specificare nell' URI) Integer Specificare l'ID del contatto di cui si desidera ricevere i dati.
id Si Integer Specificare l'ID del consenso o privacy da aggiungere al contatto.
insert_date No String Data (in formato yyyy-MM-ddTHH:mm:ssZ) nella quale il contatto ha dato il consenso.
Se questo campo non viene valorizzato viene usata la data attuale

Risposta

HTTP Status Code

CodiceDescrizione
200 ok
400

Parametri non validi, i possibili valori sono:

CONTACT_NOT_EXISTS - L'ID del contatto è errato

BAD_TYPE - Il parametro {type} è diverso da "consent" o "privacy"

BAD_ID - L'ID del consenso o privacy non è valido

BAD_DATE - La data inserita non è corretta

401 Credenziali non valide
405 Metodo HTTP non consentito
500 Errore generico

 Esempio:

   curl --user AUTH_KEY:AUTH_SECRET \
   -XPOST https://api.smshosting.it/rest/api/gdpr/contact/add/privacy/12345 \
    -d "id=123456" \
    -d "insert_date=2020-10-12T18:00:00+0200" 
{
    "gdprContactInfo": [
        {
            "consent_type": "PRIVACY",
            "consent_id": 4601,
            "granted": true,
            "insert_date": "2020-10-13T08:15:21+0200",
            "ip": "0:0:0:0:0:0:0:1",
            "source": "api",
            "consent_title": "Privacy URL"
        },
        {
            "consent_type": "CONSENT",
            "consent_id": 7687,
            "granted": false,
            "insert_date": "2020-10-12T16:25:53+0200",
            "ip": "0:0:0:0:0:0:0:1",
            "source": "api",
            "consent_title": "Do il consenso per le comunicazioni a terzi"
        }
    ]
}

Rimozione Consenso GDPR Contatto

Rimuove un consenso GDPR a un contatto

URI

DELETE https://api.smshosting.it/rest/api/gdpr/contact/remove/{type}/{id_contatto}


Richiesta

ParametroObbligatorioTipoDescrizione
type Si (Parametro da specificare nell' URI) String Specificare il tipo di consenso che si vuole rimuovere
Possbili valori: privacy, consent
id_contatto Si (Parametro da specificare nell' URI) Integer Specificare l'ID del contatto a cui si vuole rimuovere un consenso
id Si Integer Specificare l'ID del consenso o privacy da rimuovere dal contatto.

Risposta

HTTP Status Code

CodiceDescrizione
200 ok
400

Parametri non validi, i possibili valori sono:

CONTACT_NOT_EXISTS - L'ID del contatto è errato

BAD_TYPE - Il parametro {type} è diverso da "consent" o "privacy"

BAD_ID - L'ID del consenso o privacy non è valido

401 Credenziali non valide
405 Metodo HTTP non consentito
500 Errore generico

 Esempio:

   curl --user AUTH_KEY:AUTH_SECRET \
   -XDELETE https://api.smshosting.it/rest/api/gdpr/contact/remove/privacy/12345 \
    -d "id=123456" 
{
    "gdprContactInfo": [
        {
            "consent_type": "PRIVACY",
            "consent_id": 4601,
            "granted": true,
            "insert_date": "2020-10-13T08:15:21+0200",
            "ip": "0:0:0:0:0:0:0:1",
            "source": "api",
            "consent_title": "Privacy URL"
        },
        {
            "consent_type": "CONSENT",
            "consent_id": 7687,
            "granted": false,
            "insert_date": "2020-10-12T16:25:53+0200",
            "ip": "0:0:0:0:0:0:0:1",
            "source": "api",
            "consent_title": "Do il consenso per le comunicazioni a terzi"
        }
    ]
}