REST API
Материал из Planfix
Работа с API доступна только в платных или премиум-аккаунтах. Функционал REST API не полный. Мы постепенно его расширяем.
ПланФикс REST API — это набор интерфейсов, предназначенный для доступа к данным ПланФикс-аккаунта используя протокол HTTP и формат данных JSON.
API позволяет быстро и просто создавать веб- и настольные приложения, которые можно интегрировать с любым ПланФикс-аккаунтом.
Вот несколько вариантов, для чего можно использовать интерфейсы ПланФикс API:
- Создание собственных приложений или сервисов на базе ПланФикс;
- Разработка дополнений к основному функционалу ПланФикс, расширение возможностей использования сервиса;
- Импорт данных из других систем в ПланФикс;
- Экспорт данных из ПланФикса в другие системы;
- Организация уведомлений о задачах и действиях в ПланФиксе удобным для клиента способом;
- Портирование сервиса ПланФикс на другие платформы, в том числе и мобильные;
- Создание сервисов для получения и дальнейшего использования аналитической информации, находящейся в ПланФикс.
Оглавление
- Введение
- Условия использования API
- Авторизация
- Список уровней доступа – scope
- Коды ошибок
- Типы пользовательских полей
- Сложные фильтры задач
- Сложные фильтры проектов
- Сложные фильтры сотрудников
- Сложные фильтры контактов
- Сложные фильтры аналитик
- Сложные фильтры справочников
- Отчеты по API
- Работа с файлами
- Тестирование запросов по REST API в Postman
Спецификация
- Спецификация REST API доступна по ссылке: https://help.planfix.com/restapidocs/
- Если использовать ссылку на REST API из вашего аккаунта, тогда запросы будут выполняться непосредственно в вашем аккаунте, а не на тестовых данных:
Режим без уведомлений
В любом запросе обновления данных возможно добавить параметр silent=true (query parameter). При этом изменение не будет отражено в логах и по нему не будут рассылаться уведомления. Это может быть необходимо при изначальном переносе данных в ПланФикс из другой системы посредством этого API или при периодической синхронизации данных другой системы с ПланФиксом.
Дополнительно
- Поступающие в ПланФикс данные перед дальнейшим использованием можно дополнительно обработать.
- При изменении задач через REST API методом POST /task/{id} действует следующая логика: если задача находится в процессе параллельного изменения (автоматическим сценарием или другим запросом) и не может быть сейчас изменена, ожидаемое изменение сохранится в очередь внутри ПланФикса и выполнится, когда задача освободится. При этом статус ответа будет 202, если ожидаемое изменение произведено сразу — ответ 200.