Aggiornare un contatto tramite API

Tempo di lettura: 5 minuti

Difficoltà: Avanzata

Questa guida è utile se voglio capire come usare le API di 4Dem per aggiornare le informazioni di un contatto già presente in una lista della piattaforma.

In questa guida:

Creare un Api Key

Il primo passo è generare sulla tua tua console un Api Key per effettuare l'autenticazione.

Per creare o gestire un api key accedi dalla tua console alla sezione "Api Key" che trovi all'interno dell'icona "Strumenti", quindi fai click su "AGGIUNGI".

Limita un indirizzo IP

È possibile limitare l'accesso alla tua Api Key da uno specifico indirizzo IP inserendolo nell'apposito campo del popup di creazione dell' api key.

Autenticarsi su 4Dem

Generata un Api Key dovrai effettuare l'autenticazione su 4Dem.

Per effettuare la chiamata http puoi utilizzare i seguenti parametri:

Method:

POST

Url:

https://api.4dem.it/authenticate

Body:

{"APIKey":"la-tua-api-key"}

Esempio di risposta:

Per la documentazione completa puoi consultare: https://api.4dem.it/#!/Authentication/authenticate

Aggiornare un contatto

Per effettuare la chiamata http puoi utilizzare i seguenti parametri:

Documentazione:

https://api.4dem.it/#!/Contacts/subscribers_update

Method:

PUT

Url:

https://api.4dem.it/recipients/{{id_lista}}/contacts/{{id_contatto}}/update?token={{token}}

Body:

{
  "email_address": "email@domain.dev",
  "custom_fields": [
    {
      "id": 79164,
      "value": "Valore del campo Nome"
    },{
      "id": 79165,
      "value": "Valore del campo Cognome"
    }
  ]
}

ID campi personali

Gli id specificati nel body (“79164” e “79165”) sono gli id specifici dei campi personalizzati creati nella lista. Per trovare questi id, occorre andare in “Campi Personalizzati” all’interno dell’account di 4dem.it

Esempio di risposta:

Se la chiamata è formattata correttamente ma sono errati gli id dei campi, la risposta restituita è sempre 204. Le API non vanno in errore.

Riassumendo:

  • Genera l'api key dalla console.
  • Effettua l' autenticazione utilizzando i parametri forniti oppure consulta la documentazione completa.
  • Aggiorna il contatto utilizzando i parametri forniti oppure consulta la documentazione completa.