Что это
Todoist API помогает включить задачи в собственный рабочий процесс: получить список поручений, подготовить сводку или создать задачу после подтверждения. Это интерфейс системы задач, а не модель, которая понимает намерения руководителя сама.
Для новой интеграции ориентируйтесь на /api/v1. Эта версия объединяет прежние Sync v9 и REST v2; старые примеры могут отличаться маршрутами, ID и форматом ответа. Список задач теперь нужно читать как results с возможным next_cursor, а не считать обычным массивом без продолжения.
Начните с отдельного учебного проекта и чтения двух активных задач. Запись, завершение и удаление поручений подключайте после проверки правил согласования.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Программный доступ к задачам, проектам и другим ресурсам Todoist.
- Фильтр project_id ограничивает выборку нужным проектом.
- Cursor-пагинация позволяет последовательно получать списки.
- Интеграция может сначала читать данные, не меняя задачи.
Ограничения
- Личный токен не становится узким правом на один учебный проект.
- Миграция со старых API требует проверки маршрутов, ID и формата ответа.
- Сроки, приоритеты и часовые пояса нужно сверять с ожиданиями пользователя.
- Создание задачи не гарантирует, что человек согласовал ее или выполнит.
Как использовать
1. Подготовка. В отдельном учебном проекте вручную создайте две активные задачи с понятными названиями. Запишите их сроки и ожидаемое количество; рабочие поручения не меняйте.
2. Настройка. Получите API token в Settings → Integrations → Developer и храните его на сервере интеграции. Для чужих пользователей используйте подходящий OAuth-процесс. Запросы к https://api.todoist.com/api/v1 выполняйте с Authorization: Bearer TOKEN.
3. Первый результат. Через GET /projects найдите актуальный строковый ID учебного проекта, учитывая results и next_cursor. Затем выполните GET /tasks?project_id=PROJECT_ID&limit=2 и выведите id, content и due двух активных задач.
4. Проверка. Сверьте названия и сроки в интерфейсе. Если next_cursor не null, продолжайте с cursor и теми же фильтрами. Не переносите старые ID автоматически и не смешивайте /api/v1 с /rest/v1. Для записи сначала проверяйте согласование, целевой проект и повторы; первый тест ничего не завершает.
Примеры сценариев
- Вывести две активные задачи учебного проекта.
- Подготовить сводку поручений без изменения сроков.
- Создать задачу только после проверки человеком.
Доступ и оплата
- Модель оплаты: Бесплатный тариф + платные возможности
- Бесплатный тариф: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Todoist имеет бесплатный Beginner и платные планы с разными возможностями и лимитами. Самодельная интеграция и внешняя модель имеют отдельные расходы. Доступность аккаунта и оплата из России в этом проходе не проверены.
Когда не подходит
- Автоматически закрывать поручения по догадке модели
- Считать первую страницу полной выгрузкой
- Передавать личный токен в общий чат
Альтернативы
Trello REST API удобен для канбан-карточек, Asana API и ClickUp API - для процессов соответствующих командных систем. Выбирайте систему, где уже ведутся поручения, а не переносите все задачи ради одного API.
