EN RU

API MyTreeNotes


Видео на Youtube: "Mytreenotes Clicker" - это программа под Windows, как пример работы MyTreeNotes API.
API MyTreeNotes - позволяет взаимодействовать с заметками на сайте: https://mytreenotes.com
Доступ осуществляется по уникальному "id" заметки, с помощью GET или POST запросов. Можно из любых сторонних программ, скриптов, сервисов и т.п. получать данные из нужных вам заметок MyTreeNotes или отправлять из сторонних программ данные в заметки MyTreeNotes.
В приложении MyTreeNotes (для Android) можно включить синхронизацию выбранных вами заметок с сайтом mytreenotes.com , тогда изменения заметок на сайте будут попадать в приложение андроид и наоборот изменения в приложении андроид будут попадать на сайт.
Пример, посмотрите видео на YouTube: Синхронизация между облаком и приложением(android).

Таким образом можно из приложения Android чем-то управлять, например ваша или другая сторонняя программа периодически опрашивает API MyTreeNotes на наличие определенных данных и когда появятся новые данные в заметке или включен/выключен чекбокс, тогда ваша программа или устройство делает какие-то действия.
После выполненного действия или запроса, можно отправить в заметку текст с результатом.
Внимание! Ограничение: Не выполняйте запросы к API MyTreeNotes более 1 раза в 10 секунд. При многократном нарушении, работа с API в этой заметке будет автоматически заблокирована.
С помощью API можно получить доступ только к существующим заметкам на сайте в которых включена опция "Включить API". Опция "Включить API" находится на сайте и включается индивидуально для каждой заметки, в режиме редактирования заметки (кнопка "шестеренка").
С заметками можно выполнять операции: чтение, запись, добавление данных в начало или в конец заметки.

Описание API MyTreeNotes:


GET запросы:

API MyTreeNotes находится по адресу: https://mytreenotes.com/api.php
Параметр Описание
id Уникальный id заметки, обязательное поле.
Пример: id=5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F
action Действие для поля "Содержание заметки" (в заметке). Если не указано, содержание заметки не изменяется.
R - Чтение данных.
W - Перезаписать содержание заметки новыми данными.
T - Добавить новые данные в начало содержания заметки.
B - Добавить новые данные в конец содержания заметки.
Пример: action=W
check 0 - "Задача завершена" выключено
1 - "Задача завершена" включено
Пример: check=1
value Текст для сохранения в поле "содержание заметки".
Пример: value=New text
Например, ссылка на существующую заметку с которой будем работать:
https://mytreenotes.com/edt.php?id=5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F
(id этой заметки: 5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F)

Пример: GET запрос для чтения данных(содержание заметки) из заметки по id:
https://mytreenotes.com/api.php?id=5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F

Пример: GET запрос для добавления в конец поля "содержание заметки" текста "New text":
https://mytreenotes.com/api.php?id=5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F&action=B&value=New text

Пример: GET запрос для добавления в начало поля "содержание заметки" текста "The text on the top":
https://mytreenotes.com/api.php?id=5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F&action=T&value=The text on the top

Пример: GET запрос для установки поля "Задача завершена" = включено:
https://mytreenotes.com/api.php?id=5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F&action=W&check=1

Пример: GET запрос для установки поля "Задача завершена" = выключено и замена всех данных в поле "содержание заметки" на новое значение "New text":
https://mytreenotes.com/api.php?id=5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F&action=W&check=0&value=New text
Результат GET запроса возвращается в виде JSON строки. Результат будет содержать все поля из заметки с текущими значениями.
Пример результата:
{"id":"5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F","check":"1","readonly":"0","date":"1563870943","value":"Text of the note"}



POST запросы:

API MyTreeNotes находится по адресу: https://mytreenotes.com/api.php
Параметр Описание
id Уникальный id заметки, обязательное поле.
Пример: "id":"5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F"
action Действие для поля "Содержание заметки" (в заметке). Если не указано, содержание заметки не изменяется.
R - Чтение данных.
W - Перезаписать содержание заметки новыми данными.
T - Добавить новые данные в начало содержания заметки.
B - Добавить новые данные в конец содержания заметки.
Пример: "action":"W"
check 0 - "Задача завершена" выключено
1 - "Задача завершена" включено
Пример: "check":"1"
value Текст для сохранения в поле "содержание заметки".
Пример: "value":"New text"

POST запросы отправляются в виде JSON строки по адресу: https://mytreenotes.com/api.php
Поля в POST запросе должны быть в таком порядке: "id","action","check","value".
Обязательное поле "id", остальные поля не обязательные.

Пример: POST запрос для чтения данных(содержание заметки) из заметки по id:
{"id":"5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F"}

Пример: POST запрос для добавления в конец поля "содержание заметки" текста "New text":
{"id":"5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F","action":"B","value":"New text"}

Пример: POST запрос для добавления в начало поля "содержание заметки" текста "The text on the top":
{"id":"5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F","action":"T","value":"The text on the top"}

Пример: POST запрос для установки поля "Задача завершена" = включено:
{"id":"5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F","action":"W","check":"1"}

Пример: POST запрос для установки поля "Задача завершена" = выключено и замена всех данных в поле "содержание заметки" на новое значение "New text":
{"id":"5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F","action":"W","check":"0","value":"New text"}
Результат POST запроса возвращется в виде JSON строки. Результат будет содержать все поля из заметки с текущими значениями.
Пример результата:
{"id":"5GEDU2DJC5K45NKUR1Z9FSFSJ5152TSJ041F","check":"1","readonly":"0","date":"1563870943","value":"Text of the note"}



Установить MyTreeNotes (Android): https://play.google.com/store/apps/details?id=ru.iprg.mytreenotes

MyTreeNotes clicker (для Windows): https://mytreenotes.com/about/utils/clicker

Онлайн заметки: https://mytreenotes.com