AccediMenu
API

APIbeta

e-nautia ora ti offre una REST API pubblica. L'URL di base per tutte le richieste è: https://api.e-nautia.com
Essendo in versione beta, è probabile che la API possa avere delle evoluzioni in ogni momento. Iscriviti alla nostra newsletter per rimanere informato.

Gli accessi vengono fatti dal metodo POST HTTP, usando il parametro "token" ottenuto dopo la prima autenticazione. Tutte le chiamate API restituiscono un codice 200 HTTP senza consistenze e con un oggetto JSON. I caratteri vengono codificati usando UTF-8.

Quando un dato viene modificato, viene datato nel formato UTC AAAA-MM-GG HH:mm:ss attraverso una variabile di "modification".

La rimozione dei dati viene eseguita in due fasi. Una variabile associata "del" è a 1 quando la linea è stata eliminata, e a 0 se la linea esiste ancora. Quindi, per poter eliminare una linea, deve essere modificata mettendo la variabile "del" a 1. Il server di e-nautia eseguirà l'eliminazione completa dopo un mese.

Autenticazione

Identificazione

URI: /login

Dati da inviare:

Nome Digita Descrizione
login catena Identificatore o indirizzo email dell'utente
password catena Password dell'utente
lang catena Lingua da usare. Possibili valori:
de: Tedesco
en: Inglese
es: Spagnolo
fr: Francese
it: Italiano
pt: Portoghese

Risposta, se l'autenticazione fallisce:

{
"access_token":"ZkcqmSWsKnMSXq5hPpWd",
"expires_in":3600,
"token_type":"Bearer"
}
Variabile Descrizione
access_token Valore da mantenere e da riutilizzare da parte dell'applicazione
expires_in Durata in secondi, durante la quale l'uso della API con access_token è permesso
D'ora in poi dovrà essere fatta una nuova autenticazione.
token_type Metodo di generazione dell'access_token

Risposta, se l'autenticazione fallisce:

{
"errorCode":2,
"errorMessage":"La password è sbagliata."
}
Variabile Descrizione
errorCode Errore del codice
errorMessage Messaggio d'errore

Risposta, in caso di utilizzo non valido dell'access_token:

{
"statusCode":401,
"statusMessage":"invalid token"
}

Dovrà essere fatta una nuova autenticazione.

Nomi di email e FTP del server

URI: /server

Esempio di risposta:

{
"login":"georges",
"name":"Georges Lo Yeti",
"ftpserver":"e2.e-nautia.com",
"imapserver":"mail.e-nautia.com",
"popserver":"mail.e-nautia.com",
"smtpserver":"mail.e-nautia.com",
"mail":"contact@e-nautia.com"
}
Variabile Descrizione
login Identificatore
name Nome completo
ftpserver Nome del server FTP (restituito solo se l'accesso è autorizzato)
imapserver Nome del server IMAP (restituito solo se l'accesso è autorizzato)
popserver Nome del server POP (restituito solo se l'accesso è autorizzato)
smtpserver Nome del server SMTP (restituito solo se l'accesso è autorizzato)
mail Indirizzi e-mail (restituito solo se l'accesso è autorizzato)

Contatti

Recupera contatti

URI: /contacts

Esempio di risposta:

[
{"id":111,
"g":{"value":770,"modification":"2015-01-01 00:00:00"},
"email":{"value":"contact@e-nautia.com","modification":"2015-01-01 00:00:00"},
"fullname":{"value":"Georges Lo Yeti","modification":"2015-01-01 00:00:00"},
"firstname":{"value":"Georges","modification":"2015-01-01 00:00:00"},
"lastname":{"value":"Lo Yeti","modification":"2015-01-01 00:00:00"},
"homecity":{"value":"Strasbourg","modification":"2015-01-01 00:00:00"}
},
{"id":112,
"g":{"value":770,"modification":"2015-01-01 00:00:00"},
"email":{"value":"contact@e-nautia.com","modification":"2015-01-01 00:00:00"},
"fullname":{"value":"Big Foot","modification":"2015-01-01 00:00:00"},
"firstname":{"value":"Big","modification":"2015-01-01 00:00:00"},
"lastname":{"value":"Foot","modification":"2015-01-01 00:00:00"},
"homecity":{"value":"Le Havre","modification":"2015-01-01 00:00:00"}
}
]

Ogni variabile con un dato che è stato registrato è ritornata.

Dati generici:

Variabile Descrizione
id Identificatore unico del contatto
value Valori registrati
modification Data in cui i dati associati sono stati modificati l'ultima volta

Dati modificabili:

Nome Digita Descrizione
g intero Identificatore gruppo contatti
mail catena Indirizzi e-mail
firstname catena Nome
lastname catena Cognome
organization catena Nome dell'organizzazione
fullname catena Nome completo
mobilephone catena Numero cellulare
homestreet catena Indirizzo residenza personale
homecity catena Città di residenza personale
homepostalcode catena Codice postale della residenza personale
homefax catena Numero di fax della residenza personale
homephone catena Numero di telefono della linea fissa della residenza personale
birthday date Data di nascita
notes catena Nota
webpage catena Pagina web
del intero 0, se desideri ripristinare il contatto
1, se desideri eliminare il contatto

Aggiungi un contatto

URI: /contacts/add

Esempio di risposta:

{
"id":111,
{"g":770,"gname":"Amici","modification":"2015-01-01 00:00:00"},
{"email":"contact@e-nautia.com","modification":"2015-01-01 00:00:00"},
{"fullname":"Georges Lo Yeti","modification":"2015-01-01 00:00:00"},
{"firstname":"Georges","modification":"2015-01-01 00:00:00"},
{"lastname":"Lo Yeti","modification":"2015-01-01 00:00:00"},
{"homecity":"Strasbourg","modification":"2015-01-01 00:00:00"}
}

I dati registrati come contatti vengono restituiti ciascuno con la data dell'ultima modifica.

Modifica un contatto

URI: /contacts/edit/{id}
({id} per sostituire con il valore appropriato)

Esempio di risposta:

{
"id":111,
{"g":770,"gname":"Amici","modification":"2015-01-01 00:00:00"},
{"email":"contact@e-nautia.com","modification":"2015-01-01 00:00:00"},
{"fullname":"Georges Lo Yeti","modification":"2015-01-01 00:00:00"},
{"firstname":"Georges","modification":"2015-01-01 00:00:00"},
{"lastname":"Lo Yeti","modification":"2015-01-01 00:00:00"},
{"homecity":"Strasbourg","modification":"2015-01-01 00:00:00"}
{"del":1,"modification":"2015-01-01 00:00:00"}
}

I dati registrati come contatti vengono restituiti ciascuno con la data dell'ultima modifica.

Categorie dei contatti

Recupera categorie dei contatti

URI: /contacts/groups

Esempio di risposta:

[
{"id":770,
"name":{"value":"Amici","modification":"2015-01-01 00:00:00"},
}
{"id":771,
"name":{"value":"Compito","modification":"2015-01-01 00:00:00"}
}
]

Ogni variabile con un dato che è stato registrato è ritornata.

Dati generici:

Variabile Descrizione
id Identificatore unico del contatto
value Valori registrati
modification Data in cui i dati associati sono stati modificati l'ultima volta

Dati modificabili:

Nome Digita Descrizione
name catena Nome della categoria
del intero 0, se desideri ripristinare la categoria
1, se desideri eliminare la categoria

Aggiungi una categoria di contatti

URI: /contacts/groups/add

Esempio di risposta:

{
"id":770,
{"name":"Amici","modification":"2015-01-01 00:00:00"}
}

I dati registrati come categoria vengono restituiti ciascuno con la data dell'ultima modifica.

Modifica una categoria di contatti

URI: /contacts/groups/edit/{id}
({id} per sostituire con il valore appropriato)

Esempio di risposta:

{
"id":770,
{"name":"Amici","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

I dati registrati come categoria vengono restituiti ciascuno con la data dell'ultima modifica.

Note

Recupera note

URI: /notes

Esempio di risposta:

[
{"id":11,
"title":{"value":"Compiti da portare a termine","modification":"2015-01-01 00:00:00"},
"note":{"value":"Pulizie","modification":"2015-01-01 00:00:00"},
"del":{"value":0,"modification":"2015-01-01 00:00:00"}
},
{"id":12,
"title":{"value":"Shopping","modification":"2015-01-01 00:00:00"},
"note":{"value":"Patate e molto altro","modification":"2015-01-01 00:00:00"},
"del":{"value":1,"modification":"2015-01-01 00:00:00"}
}
]

Ogni variabile con un dato che è stato registrato è ritornata.

Dati generici:

Variabile Descrizione
id Identificatore unico della nota
value Valori registrati
modification Data in cui i dati associati sono stati modificati l'ultima volta

Dati modificabili:

Nome Digita Descrizione
title catena Titolo
note testo Contenuto della nota
del intero 0, se desideri ripristinare la nota
1, se desideri eliminare la nota

Aggiungi una nota

URI: /notes/add

Esempio di risposta:

{
"id":11,
{"title":"Compiti da portare a termine","modification":"2015-01-01 00:00:00"},
{"note":"Pulizie","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

I dati registrati come note vengono restituiti ciascuno con la data dell'ultima modifica.

Modifica una nota

URI: /notes/edit/{id}
({id} per sostituire con il valore appropriato)

Esempio di risposta:

{
"id":11,
{"title":"Compiti da portare a termine","modification":"2015-01-01 00:00:00"},
{"note":"Pulizie","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

I dati registrati come note vengono restituiti ciascuno con la data dell'ultima modifica.

Calendario

Recupera appuntamenti

URI: /calendar

Esempio di risposta:

[
{"id":99,
"title":{"value":"Una serata con gli amici","modification":"2015-01-01 00:00:00"},
"start":{"value":"2016-01-01 20:00:00","modification":"2015-01-01 00:00:00"},
"end":{"value":"2016-01-01 22:30:00","modification":"2015-01-01 00:00:00"},
"place":{"value":"Da Bibi","modification":"2015-01-01 00:00:00"},
"del":{"value":1,"modification":"2015-01-01 00:00:00"}
},
{"id":105,
"title":{"value":"Lezioni","modification":"2015-01-01 00:00:00"},
"start":{"value":"2016-09-01 09:00:00","modification":"2015-01-01 00:00:00"},
"end":{"value":"2016-06-30 17:30:00","modification":"2015-01-01 00:00:00"},
"re":{"value":"|N1|N2|N3|N4|N5|","modification":"2015-01-01 00:00:00"}
}
]

Ogni variabile con un dato che è stato registrato è ritornata.

Dati generici:

Variabile Descrizione
id Identificatore unico dell'appuntamento
value Valori registrati
modification Data in cui i dati associati sono stati modificati l'ultima volta

Dati modificabili:

Nome Digita Descrizione
title catena Titolo
start data e ora Data d'inizio
end data e ora Data di fine
description Note Descrizione
place testo Indirizzo
re catena Recupera appuntamenti
Se ci sono ripetizioni da applicare, esse vengono separate dal carattere | e vengono presentate come nei seguenti esempi.
Un giorno della settimana: N seguito dal numero del giorno (da 1 per lunedì a 7 per domenica)
Un giorno del mese: d seguito dal numero del giorno (da 01 a 31)
Mese: m seguito dal numero del mese (da 01 a 12)
Esempio: |N1|N2|m12| per una ripetizione da applicare ogni lunedì e giovedì di dicembre
del intero 0, se desideri ripristinare l'appuntamento
1, se desideri eliminare l'appuntamento

Aggiungi un appuntamento

URI: /calendar/add

Esempio di risposta:

{
"id":99,
{"title":"Una serata con gli amici","modification":"2015-01-01 00:00:00"},
{"start":"2016-01-01 20:00:00","modification":"2015-01-01 00:00:00"},
{"end":"2016-01-01 22:30:00","modification":"2015-01-01 00:00:00"},
{"place":"Da Bibi","modification":"2015-01-01 00:00:00"}
}

I dati registrati come appuntamenti verranno restituiti ciascuno con la data dell'ultima modifica.

Modifica un appuntamento

URI: /calendar/edit/{id}
({id} per sostituire con il valore appropriato)

Esempio di risposta:

{
"id":99,
{"title":"Una serata con gli amici","modification":"2015-01-01 00:00:00"},
{"start":"2016-01-01 20:00:00","modification":"2015-01-01 00:00:00"},
{"end":"2016-01-01 22:30:00","modification":"2015-01-01 00:00:00"},
{"place":"Da Bibi","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

I dati registrati come appuntamenti verranno restituiti ciascuno con la data dell'ultima modifica.

SMS

Invia un SMS

URI: /send/send

Dati modificabili:

Nome Digita Descrizione
number catena Il numero del destinatario è in formato internazionale (+CCXXXXXXXXX dove CC è il codice del paese e XXXXXXXXX è il numero locale)
message testo Messaggio di 160 caratteri al massimo

Esempio di risposta:

{
"code":1,
"message":"SMS inviato"
}

Dati generici:

Variabile Descrizione
code Codice di ritorno – Possibili valori:
1: SMS inviato
2: numero errato
3: credito insufficiente. Per favore ricarica il tuo account.
4: quota raggiunta. Per favore riprova più tardi.
5: errore interno. Per favore contatta l'assistenza.
message Descrizione del codice restituito
DeutschEnglishEspañolFrançaisItalianoPortuguês
© e-nautia[IT] ▲ Termini di Utilizzo Newsletter Contatti Aiuto