ConexiónMenú
API

APIbeta

e-nautia ahora te ofrece un API REST público. La URL de base para todas las llamadas es: https://api.e-nautia.com
Al estar en la versión beta, la API tiene la posibilidad de evolucionar en cualquier momento. Suscríbete a nuestro boletín para mantenerte informado.

Los accesos se realizan por el método HTTP POST, mediante el parámetro "token" obtenido después de la primera autenticación. Todas las llamadas API devuelven un código HTTP 200 sin consistencias, con un objeto JSON. Los caracteres se codifican utilizando UTF-8.

Cuando un dato es modificado, está fechado en el formato UTC YYYY-MM-DD HH:mm:ss a través la variable "modification".

La eliminación de datos se realiza en dos fases. Una variable asociada a "del" está en 1, cuando la línea ha sido borrada y está en 0 cuando todavía existe la línea. Por tanto, con el fin de eliminar una línea, debe ser editada poniendo la variable "del" a 1. El servidor de e-nautia llevará a cabo la eliminación completa después de un mes.

Autentificación

Autentificación

URI: /login

Datos para enviar:

Nombre Tipo Descripción
login cadena Identificador o dirección de correo electrónico del usuario
password cadena Contraseña del usuario
lang cadena Idioma que se utilizará. Posibles valores:
de: Alemán
en: Inglés
es: Español
fr: Francés
it: Italiano
jp: Japanese
nl: Holandés
pt: Portugués
ru: Ruso

Respuesta, si la autenticación falla:

{
"access_token":"ZkcqmSWsKnMSXq5hPpWd",
"expires_in":3600,
"token_type":"Bearer"
}
Variable Descripción
access_token Valor para conservar y para ser reutilizado por la aplicación
expires_in Duración en segundos, durante la cual se permite el uso de la API con access_token
Desde ahora, una nueva autenticación debe realizarse.
token_type Método para generar la access_token

Respuesta, si la autenticación falla:

{
"errorCode":2,
"errorMessage":"La contraseña es incorrecta."
}
Variable Descripción
errorCode Código de error
errorMessage Mensaje de error

Respuesta, en caso de una utilización no válida de un access_token:

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

Deberá hacerse una nueva autentificación.

Los nombres de los correos electrónicos del servidor y FTP

URI: /server

Ejemplo de una respuesta:

{
"login":"georges",
"name":"Georges El 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"
}
Variable Descripción
login Identificador
name Nombre completo
ftpserver Nombre del servidor FTP (será devuelto sólo si está autorizado el acceso)
imapserver Nombre del servidor IMAP (será devuelto sólo si está autorizado el acceso)
popserver Nombre del servidor POP (será devuelto sólo si está autorizado el acceso)
smtpserver Nombre del servidor SMTP (será devuelto sólo si está autorizado el acceso)
mail Dirección de correo electrónico (será devuelto sólo si está autorizado el acceso)

Contactos

Recuperar contactos

URI: /contacts

Ejemplo de una respuesta:

[
{"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 El Yeti","modification":"2015-01-01 00:00:00"},
"firstname":{"value":"Georges","modification":"2015-01-01 00:00:00"},
"lastname":{"value":"El 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"}
}
]

Cada variable con un dato que ha sido registrado ha retornado.

Datos genéricos:

Variable Descripción
id Identificador único del contacto
value Valor registrado
modification Fecha en la que los datos asociados fueron modificados por última vez

Datos editables:

Nombre Tipo Descripción
g entero Identificador del grupo de contacto
mail cadena Dirección de correo electrónico
firstname cadena Nombre
lastname cadena Apellido
organization cadena Nombre de la organización
fullname cadena Nombre completo
mobilephone cadena Número de celular
homestreet cadena Dirección residencial personal
homecity cadena Ciudad residencial personal
homepostalcode cadena Código postal residencial personal
homefax cadena Número de fax residencial personal
homephone cadena Número de teléfono fijo residencial personal
birthday date Fecha de nacimiento
notes cadena Nota
webpage cadena Página Web
del entero 0, si deseas restaurar el contacto
1, si deseas eliminar el contacto

Añadir un contacto

URI: /contacts/add

Ejemplo de una respuesta:

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

Los datos registrados como contacto son devueltos con, para cada uno, la última fecha de modificación.

Modificar un contacto

URI: /contacts/edit/{id}
({id} para reemplazar con el valor adecuado)

Ejemplo de una respuesta:

{
"id":111,
{"g":770,"gname":"Amigos","modification":"2015-01-01 00:00:00"},
{"email":"contact@e-nautia.com","modification":"2015-01-01 00:00:00"},
{"fullname":"Georges El Yeti","modification":"2015-01-01 00:00:00"},
{"firstname":"Georges","modification":"2015-01-01 00:00:00"},
{"lastname":"El 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"}
}

Los datos registrados como contacto son devueltos con, para cada uno, la última fecha de modificación.

Categorías de contacto

Recuperar categorías de contacto

URI: /contacts/groups

Ejemplo de una respuesta:

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

Cada variable con un dato que ha sido registrado ha retornado.

Datos genéricos:

Variable Descripción
id Identificador único del contacto
value Valor registrado
modification Fecha en la que los datos asociados fueron modificados por última vez

Datos editables:

Nombre Tipo Descripción
name cadena Nombre de la categoría
del entero 0, si deseas restaurar la categoría
1, si deseas eliminar la categoría

Añadir una categoría de contacto

URI: /contacts/groups/add

Ejemplo de una respuesta:

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

Los datos registrados en la categoría se devuelven con, para cada uno, la última fecha de modificación.

Modificar una categoría de contacto

URI: /contacts/groups/edit/{id}
({id} para reemplazar con el valor adecuado)

Ejemplo de una respuesta:

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

Los datos registrados en la categoría se devuelven con, para cada uno, la última fecha de modificación.

Notas

Recuperar notas

URI: /notes

Ejemplo de una respuesta:

[
{"id":11,
"title":{"value":"Tareas a realizar","modification":"2015-01-01 00:00:00"},
"note":{"value":"Limpieza","modification":"2015-01-01 00:00:00"},
"del":{"value":0,"modification":"2015-01-01 00:00:00"}
},
{"id":12,
"title":{"value":"Compras","modification":"2015-01-01 00:00:00"},
"note":{"value":"Patatas y mucho más","modification":"2015-01-01 00:00:00"},
"del":{"value":1,"modification":"2015-01-01 00:00:00"}
}
]

Cada variable con un dato que ha sido registrado ha retornado.

Datos genéricos:

Variable Descripción
id Identificador único de la nota
value Valor registrado
modification Fecha en la que los datos asociados fueron modificados por última vez

Datos editables:

Nombre Tipo Descripción
title cadena Título
note texto Contenido de la nota
del entero 0, si deseas restaurar la nota
1, si deseas eliminar la nota

Agrega una nota

URI: /notes/add

Ejemplo de una respuesta:

{
"id":11,
{"title":"Tareas a realizar","modification":"2015-01-01 00:00:00"},
{"note":"Limpieza","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

Los datos registrados como nota se devuelven con, para cada una, la última fecha de modificación.

Modificar una nota

URI: /notes/edit/{id}
({id} para reemplazar con el valor adecuado)

Ejemplo de una respuesta:

{
"id":11,
{"title":"Tareas a realizar","modification":"2015-01-01 00:00:00"},
{"note":"Limpieza","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

Los datos registrados como nota se devuelven con, para cada una, la última fecha de modificación.

Calendario

Recuperar fechas

URI: /calendar

Ejemplo de una respuesta:

[
{"id":99,
"title":{"value":"Una tarde con los amigos","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":"En Bibi","modification":"2015-01-01 00:00:00"},
"del":{"value":1,"modification":"2015-01-01 00:00:00"}
},
{"id":105,
"title":{"value":"Clases","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"}
}
]

Cada variable con un dato que ha sido registrado ha retornado.

Datos genéricos:

Variable Descripción
id Identificador único de la cita
value Valor registrado
modification Fecha en la que los datos asociados fueron modificados por última vez

Datos editables:

Nombre Tipo Descripción
title cadena Título
start fecha y hora Fecha de inicio
end fecha y hora Fecha final
description Notas Descripción
place texto Dirección
re cadena Recuperar fechas
Si hay recurrencias para aplicar, están separadas por el carácter | y se presentan como en los siguientes ejemplos.
Un día de la semana: N seguido del número del día (de 1 para lunes a 7 para el domingo)
Un día del mes: d seguido del número del día (de 01 a 31)
Mes: m seguido del número del mes (de 01 a 12)
Ejemplo: |N1|N2|m12| para una recurrencia que sea aplicada cada lunes y martes de diciembre
del entero 0, si deseas restaurar la cita eliminada
1, si deseas eliminar la cita

Añadir una cita

URI: /calendar/add

Ejemplo de una respuesta:

{
"id":99,
{"title":"Una tarde con los amigos","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":"En Bibi","modification":"2015-01-01 00:00:00"}
}

Los datos registrados como cita se devuelven con, para cada uno, la última fecha de modificación.

Modificar una cita

URI: /calendar/edit/{id}
({id} para reemplazar con el valor adecuado)

Ejemplo de una respuesta:

{
"id":99,
{"title":"Una tarde con los amigos","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":"En Bibi","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

Los datos registrados como cita se devuelven con, para cada uno, la última fecha de modificación.

SMS

Enviar un SMS

URI: /send/send

Datos editables:

Nombre Tipo Descripción
number cadena Número de destinatarios en el formato internacional (+CCXXXXXXXXX donde CC es el código del país y XXXXXXXXX es el número local)
message texto Mensaje de 160 caracteres como máximo

Ejemplo de una respuesta:

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

Datos genéricos:

Variable Descripción
code Código de retorno - Posibles valores:
1: SMS enviado
2: número incorrecto
3: crédito insuficiente. Por favor, recarga tu cuenta.
4: cuota alcanzada. Por favor, vuelve a intentarlo más tarde.
5: error interno. Por favor, ponte en contacto con el equipo de asistencia.
message Descripción del código devuelto
DeutschEnglishEspañolFrançaisItalianoNederlandsPortuguêsРусский日本の
© e-nautia[ES] ▲ Condiciones de uso Newsletter Contactos Ayuda