Come creare una lista tramite API

Tempo di lettura: 5 minuti

Difficoltà: Avanzata

Tramite le API di 4DEM puoi creare una lista sull’ account della tua console in modo rapido e veloce, vediamo insieme i vari passaggi.

In questa guida:

Login e creazione 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 "Impostazioni", cliccando dove leggi il tuo nome in basso, e vai in "Developers".

Da qui va in "Api Key". Clicca su Aggiungi e crea la tua nuova api key.

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.

Autenticazione

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

Creazione della lista

Controlla quante liste prevede il tuo piano

Per verificare se c’è la possibilità di creare una lista sul proprio account è opportuno utilizzare l’endpoint GET /recipients (https://api.4dem.it/#!/Recipients/recipients_index) controllando il numero di liste attualmente disponibili sull’account. Solo a questo punto è opportuno procedere nella creazione di una nuova lista.

Per effettuare la chiamata puoi utilizzare i seguenti parametri:

Method:

POST

Url:

https://api.4dem.it/recipients?token={{token}}

Body:

{
  "name": "my recipient",
  "send_activity_notification": false,
  "email_address_notify": "",
  "subscription": {
    "confirmed_page_url": "http://www.mydomain.it/my_confirm_page.html",
    "error_page_url": "http://www.mydomain.it/my_error_page.html",
    "pending_page_url": "http://www.mydomain.it/my_pending_page.html"
  },
  "unsubscription": {
    "confirmed_page_url": "http://www.mydomain.it/my_unsub_confirm_page.html",
    "error_page_url": "http://www.mydomain.it/my_unsub_error_page.html"
  },
  "opt_in": {
    "email_id": 1501,
    "mode": "double",
    "subscribe_to": 15,
    "unsubscribe_from": 14
  },
  "opt_out": {
    "mode": "confirm",
    "scope": "this_list",
    "add_to_global_suppression": true,
    "unsubscribe_from": 14,
    "subscribe_to": 15
  },
  "integration": {
    "last_sync_date": "2016-06-02 15:04:34",
    "active": false,
    "domain": "www.yourDomainSite.com",
    "module": "Magento"
  },
  "descriptions_fields": {
    "origin": "From my private database",
    "refer": "My blog",
    "short_description": "Used for pet newsletter"
  },
  "custom_fields": [
    {
      "name": "city",
      "type": "Single line",
      "placeholder": "CITY",
      "default_value": "",
      "visibility": "Public",
      "year": {
        "from": 1980,
        "to": 2020
      },
      "validation": {
        "method": "Disabled",
        "rule": "",
        "required": false,
        "unique": false
      },
      "options": [
        {
          "label": "",
          "value": "",
          "selected": true
        }
      ]
    }
  ]
}
La risposta restituisce l’id della lista appena creata. Se la creazione non dovesse andare a buon fine, nel response body viene data traccia del motivo di errore.

Riassumendo