ВойтиМеню
API

APIbeta

e-nautia предлагает для вас публичный REST API. Основной URL для всех запросов: https://api.e-nautia.com
Сейчас API работает в beta-версии и может развиться дальше в любое время. Подпишитесь на нашу рассылку, чтобы оставаться в курсе новостей.

Доступы реализованы методом POST HTTP, с использованием параметра "token", полученного после первой аутентификации. Все API-запросы возвращают HTTP-код 200 без последовательностей, с объектом JSON. Для кодировки символов используется UTF-8.

Когда данные изменены, дата изменений сохранена в формате UTC YYYY-MM-DD HH:mm:ss помощью "modification" переменной.

Удаление данных происходит в два этапа. Переменная "del" имеет значение 1, когда строка удалена, и значение 0, когда строка существует. Поэтому для того, чтобы удалить строку, отредактируйте её, присвоив переменной "del" значение 1. Сервер e-nautia полностью удалит данные через один месяц.

Проверка подлинности

Идентификация

URI: /login

Данные для отправки:

Имя Тип Описание
login цепочка Идентификатор или эл.адрес пользователя
password цепочка Пароль пользователя
lang цепочка Используемые языки. Возможные варианты:
de: Немецкий
en: Английский
es: Испанский
fr: Французский
it: Итальянский
ja: Японский
nl: Голландский
pt: Португальский
ru: Русский

Ответ, если проверка подлинности не удалась:

{
"access_token":"ZkcqmSWsKnMSXq5hPpWd",
"expires_in":3600,
"token_type":"Bearer"
}
Переменная Описание
access_token Значения для сохранения и повторного использования приложением
expires_in Продолжительность в секундах, в течение которой использование API с access_token разрешено
Здесь и далее, требуется повторная проверка подлинности.
token_type Метод создания access_token

Ответ, если проверка подлинности не удалась:

{
"errorCode":2,
"errorMessage":"Пароль неверен."
}
Переменная Описание
errorCode Код ошибки
errorMessage Сообщение об ошибке

Ответ в случае недопустимого использования access_token:

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

Проверка подлинности будет произведена заново.

Имена почтовых серверов и FTP

URI: /server

Пример ответа:

{
"login":"georges",
"name":"Georges The 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"
}
Переменная Описание
login Идентификатор
name Полное имя
ftpserver Имя сервера FTP (возвращается только, если доступ разрешён)
imapserver Имя IMAP сервера (возвращается только, если доступ разрешён)
popserver Имя POP сервера (возвращается только, если доступ разрешён)
smtpserver Имя SMTP сервера (возвращается только, если доступ разрешён)
mail Адрес эл.почты (возвращается только, если доступ разрешён)

Контакты

Восстановить контакты

URI: /contacts

Пример ответа:

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

Каждая переменная с записанной величиной возвращена.

Общие данные:

Переменная Описание
id Уникальный идентификатор контакта
value Записанное значение
modification Дата изменения связанных данных

Редактируемые данные:

Имя Тип Описание
g целое число Идентификатор группы контактов
mail цепочка Адрес эл.почты
firstname цепочка Имя
lastname цепочка Фамилия
organization цепочка Название организации
fullname цепочка Полное имя
mobilephone цепочка Мобильный номер
homestreet цепочка Адрес места жительства
homecity цепочка Город места жительства
homepostalcode цепочка Почтовый индекс
homefax цепочка Номер факса
homephone цепочка Городской номер телефона
birthday date Дата рождения
notes цепочка Заметка
webpage цепочка Веб-страница
del целое число 0, если вы хотите восстановить контакт
1, если вы хотите удалить контакт

Добавить контакт

URI: /contacts/add

Пример ответа:

{
"id":111,
{"g":770,"gname":"Друзья","modification":"2015-01-01 00:00:00"},
{"email":"contact@e-nautia.com","modification":"2015-01-01 00:00:00"},
{"fullname":"Georges The Yeti","modification":"2015-01-01 00:00:00"},
{"firstname":"Georges","modification":"2015-01-01 00:00:00"},
{"lastname":"The Yeti","modification":"2015-01-01 00:00:00"},
{"homecity":"Strasbourg","modification":"2015-01-01 00:00:00"}
}

Данные, записанные в контакте, отображаются с последними изменениями.

Изменить контакт

URI: /contacts/edit/{id}
({id} для замены на соответствующее значение)

Пример ответа:

{
"id":111,
{"g":770,"gname":"Друзья","modification":"2015-01-01 00:00:00"},
{"email":"contact@e-nautia.com","modification":"2015-01-01 00:00:00"},
{"fullname":"Georges The Yeti","modification":"2015-01-01 00:00:00"},
{"firstname":"Georges","modification":"2015-01-01 00:00:00"},
{"lastname":"The 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"}
}

Данные, записанные в контакте, отображаются с последними изменениями.

Категории контактов

Загрузить категории контактов

URI: /contacts/groups

Пример ответа:

[
{"id":770,
"name":{"value":"Друзья","modification":"2015-01-01 00:00:00"},
}
{"id":771,
"name":{"value":"Задача","modification":"2015-01-01 00:00:00"}
}
]

Каждая переменная с записанной величиной возвращена.

Общие данные:

Переменная Описание
id Уникальный идентификатор контакта
value Записанное значение
modification Дата изменения связанных данных

Редактируемые данные:

Имя Тип Описание
name цепочка Название категории
del целое число 0, если вы хотите восстановить категорию
1, если вы хотите удалить категорию

Добавить категорию контактов

URI: /contacts/groups/add

Пример ответа:

{
"id":770,
{"name":"Друзья","modification":"2015-01-01 00:00:00"}
}

Данные, записанные в категории, отображаются с последними изменениями.

Изменить категорию контактов

URI: /contacts/groups/edit/{id}
({id} для замены на соответствующее значение)

Пример ответа:

{
"id":770,
{"name":"Друзья","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

Данные, записанные в категории, отображаются с последними изменениями.

Заметки

Восстановить заметки

URI: /notes

Пример ответа:

[
{"id":11,
"title":{"value":"Задачи для выполнения","modification":"2015-01-01 00:00:00"},
"note":{"value":"Уборка","modification":"2015-01-01 00:00:00"},
"del":{"value":0,"modification":"2015-01-01 00:00:00"}
},
{"id":12,
"title":{"value":"Шоппинг","modification":"2015-01-01 00:00:00"},
"note":{"value":"Картофель и многое другое","modification":"2015-01-01 00:00:00"},
"del":{"value":1,"modification":"2015-01-01 00:00:00"}
}
]

Каждая переменная с записанной величиной возвращена.

Общие данные:

Переменная Описание
id Уникальные идентификатор заметки
value Записанное значение
modification Дата изменения связанных данных

Редактируемые данные:

Имя Тип Описание
title цепочка Заголовок
note текст Содержание заметки
del целое число 0, если вы хотите восстановить заметку
1, если вы хотите удалить заметку

Добавить заметку

URI: /notes/add

Пример ответа:

{
"id":11,
{"title":"Задачи для выполнения","modification":"2015-01-01 00:00:00"},
{"note":"Уборка","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

Данные, записанные в заметке, отображаются с последними изменениями.

Изменить заметку

URI: /notes/edit/{id}
({id} для замены на соответствующее значение)

Пример ответа:

{
"id":11,
{"title":"Задачи для выполнения","modification":"2015-01-01 00:00:00"},
{"note":"Уборка","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

Данные, записанные в заметке, отображаются с последними изменениями.

Календарь

Загрузить встречи

URI: /calendar

Пример ответа:

[
{"id":99,
"title":{"value":"Вечер с друзьями","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":"У Bibi","modification":"2015-01-01 00:00:00"},
"del":{"value":1,"modification":"2015-01-01 00:00:00"}
},
{"id":105,
"title":{"value":"Классы","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"}
}
]

Каждая переменная с записанной величиной возвращена.

Общие данные:

Переменная Описание
id Уникальный идентификатор встречи
value Записанное значение
modification Дата изменения связанных данных

Редактируемые данные:

Имя Тип Описание
title цепочка Заголовок
start дата и время Дата начала
end дата и время Дата окончания
description Заметки Описание
place текст Адрес
re цепочка Загрузить встречи
Если необходимо настроить повторяющиеся операции, то они должны быть разделены символом | и представлены так, как в следующих примерах.
День недели: N с номером дня ( от 1 для Понедельника до 7 для Воскресенья)
День месяца: d с номером дня (от 01 до 31)
Месяц: m с номером месяца (from 01 to 12)
Пример: |N1|N2|m12| для повторяющихся операций каждый понедельник и вторник декабря.
del целое число 0, если вы хотите восстановить удалённое целевое назначение
1, если вы хотите удалить целевое назначение

Добавить встречу

URI: /calendar/add

Пример ответа:

{
"id":99,
{"title":"Вечер с друзьями","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":"У Bibi","modification":"2015-01-01 00:00:00"}
}

Данные возвращаются с изменениями на последнюю дату с указанием целевого назначения.

Изменить целевое назначение

URI: /calendar/edit/{id}
({id} для замены на соответствующее значение)

Пример ответа:

{
"id":99,
{"title":"Вечер с друзьями","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":"У Bibi","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

Данные возвращаются с изменениями на последнюю дату с указанием целевого назначения.

SMS

Отправить SMS

URI: /send/send

Редактируемые данные:

Имя Тип Описание
number цепочка Номер получателя в международном формате (+CCXXXXXXXXX, где CC – код страны, и XXXXXXXXX – местный номер)
message текст Сообщение максимум 160 символов

Пример ответа:

{
"code":1,
"message":"SMS отправлено"
}

Общие данные:

Переменная Описание
code Код возврата – Возможные значения:
1: SMS отправлено
2: неверный номер
3: недостаточно средств. Пожалуйста, пополните ваш аккаунт.
4: квота исчерпана. Пожалуйста, попробуйте ещё раз позже.
5: внутренняя ошибка. Пожалуйста, свяжитесь с техподдержкой.
message Описание кода возврата
DeutschEnglishEspañolFrançaisItalianoNederlandsPortuguêsРусскийそして
© e-nautia[RU] ▲ Условия использования Рассылка Контакты Помощь