Notemi API
Подключи Notemi к своему скрипту или сервису: читай и создавай заметки, задачи и ссылки, раскладывай их по категориям. API работает на любом тарифе.
Документация
Все методы с параметрами и примерами ответов. Описание в OpenAPI можно загрузить в Postman или собрать по нему клиент.
Токен
Токен создаётся в настройках приложения. С доступом «Чтение» он только читает записи, с доступом «Чтение и запись» ещё создаёт, меняет и удаляет их. Срок — 30 дней, 90 дней, год или бессрочно.
Частые вопросы
Как передать токен?
В заголовке Authorization: Bearer ntm_…. Отозвать токен можно там же, в настройках, и сервисы с ним сразу перестанут работать.
Сколько запросов можно делать?
60 в минуту на один токен. Сколько осталось, показывают заголовки RateLimit-Limit и RateLimit-Remaining. Сверх лимита API ответит 429, а в Retry-After укажет, когда повторить.
Можно вызывать API прямо со страницы сайта?
Нет, такие запросы блокирует CORS, чтобы токен не оказался в браузерном коде чужого сайта. Вызывай API с сервера или из расширения браузера.
Как узнавать об изменениях?
Опрашивай GET /v1/items/changes, передавая в since значение serverTime из прошлого ответа. Изменения последней минуты могут прийти ещё раз, поэтому повторы отсекай по id и version.
В каком формате тело заметки?
В Markdown (GFM), и при чтении, и при записи. Если отправить content обратно без правок, заметка не изменится.
Сломается ли интеграция после обновления API?
Внутри v1 мы только добавляем новое: необязательные параметры, поля ответа и методы. Чтобы интеграция продолжала работать, не отвергай незнакомые поля в ответе.