come creare campi personalizzati 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:

Prima di cominciare

Non è possibile creare un campo personalizzato su una lista che non esiste. Prima di procedere alla creazione di un campo personalizzato occorre creare una lista e recuperare il suo id.

Login e creazione Api Key

Per creare o gestire un api key accedi dalla tua console alla sezione "Impostazioni" (raggiungibile dove leggi il tuo nome) 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 del campo personalizzato

Documentazione:

https://api.4dem.it/#!/Custom_Fields/customfields_store

Method:

POST

Url:

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

Body:

{
"recipient_id": 3434,
"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
}
]
}

Il type indica il tipo di campo personalizzato che si vuole creare. Far riferimento alla documentazione API per l’elenco completo di tutti i tipi disponibili.

Una lista può avere due campi personalizzati diversi con lo stesso nome è quindi buona norma chiamare i campi personalizzati con nomi differenti e facilmente riconoscibili per distinguerli facilmente.

Riassumendo