English Version

Test con Postman^©

Gestione Consensi e Privacy

Lista Informative Privacy
Lista Consensi GDPR
Storico Consensi GDPR Contatto
Consensi GDPR Contatto
Aggiunta Consenso GDPR Contatto
Rimozione Consenso GDPR Contatto

Lista Informative Privacy

Restituisce la lista delle Informative Privacy dell'utente.

URI

GET https://api.amm.cloud/sms/v2/gdpr/privacy/list

Richiesta

Parametro	Obbligatorio	Tipo	Descrizione
only_visible	No	Boolean	Indica se restituire solo le Informative Privacy attualmente visibili o meno.

Risposta

HTTP Status Code

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

Esempio:

   curl --user AUTH_KEY:AUTH_SECRET \
   -XGET https://api.amm.cloud/sms/v2/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.amm.cloud/sms/v2/gdpr/consent/list

Richiesta

Parametro	Obbligatorio	Tipo	Descrizione
only_visible	No	Boolean	Indica se restituire solo i consensi GDPR attualmente visibili o meno.

Risposta

HTTP Status Code

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

Esempio:

   curl --user AUTH_KEY:AUTH_SECRET \
   -XGET https://api.amm.cloud/sms/v2/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.amm.cloud/sms/v2/gdpr/history/contact/{id_contatto}

Richiesta

Parametro	Obbligatorio	Tipo	Descrizione
id_contatto	Si (Parametro da specificare nell' URI)	Integer	Specificare l'ID del contatto di cui si desidera ricevere lo storico.

Risposta

HTTP Status Code

Codice	Descrizione
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.amm.cloud/sms/v2/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.amm.cloud/sms/v2/gdpr/contact/{id_contatto}

Richiesta

Parametro	Obbligatorio	Tipo	Descrizione
id_contatto	Si (Parametro da specificare nell' URI)	Integer	Specificare l'ID del contatto di cui si desidera ricevere i dati.

Risposta

HTTP Status Code

Codice	Descrizione
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.amm.cloud/sms/v2/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.amm.cloud/sms/v2/gdpr/contact/add/{type}/{id_contatto}

Richiesta

Parametro	Obbligatorio	Tipo	Descrizione
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

Codice	Descrizione
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.amm.cloud/sms/v2/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.amm.cloud/sms/v2/gdpr/contact/remove/{type}/{id_contatto}

Richiesta

Parametro	Obbligatorio	Tipo	Descrizione
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

Codice	Descrizione
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.amm.cloud/sms/v2/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"
        }
    ]
}