Приведу пример url запроса, который создает новую задачу в облачной системе Bitrix24 (в коробочной версии этот функционал также работает, но начиная с версии Битрикс24 16.6.0).
Для начала нужно создать новый входящий вебхук. Как создавать, я описал здесь: Bitrix24 cоздание лида через API. Права для вебхука выбираем: «Задачи (task)» и «Задачи (расширенные права)»
Для общего понимания желательно ознакомится с документацией по REST API Bitrix24: Документация по REST.
После получения токена, приступаем к формированию запросов.
Чтобы получить информацию о конкретной задачи, выполните в браузере:
1 | https://b24-adminblog.bitrix24.ua/rest/1/yi4qds45455aaq3nyjq1r/tasks.task.get.json?id=1 |
Где
- tasks.task.get — метод REST API
- json — формат возвращаемой информации (поддерживает также xml)
- id=1 — Id задачи
Чтобы получить список всех задач, выполните в браузере:
1 | https://b24-adminblog.bitrix24.ua/rest/1/yi4qds45455aaq3nyjq1r/tasks.task.list.json |
Чтобы поставить новую задачу, выполните в браузере:
1 | https://b24-adminblog.bitrix24.ua/rest/1/yi4qds45455aaq3nyjq1r/tasks.task.add.json?fields[TITLE]=test&fields[RESPONSIBLE_ID]=1 |
Где
- fields[TITLE]=test — Название задачи
- fields[RESPONSIBLE_ID]=1 — id ответственного
Также Вам может понадобится список поддерживаемых полей. Для вывода из списка, выполните в браузере:
1 | https://b24-adminblog.bitrix24.ua/rest/1/yi4qds45455aaq3nyjq1r/tasks.task.getfields.json |
С выводом удобно работать, если использовать онлайн сервис форматирования JSON кода, например jsonformatter.org
Пример запроса добавления чек листа к задаче:
1 | https://b24-adminblog.bitrix24.ua/rest/1/yi4qds45455aaq3nyjq1r/task.checklistitem.add.json?TASKID=11&FIELDS[TITLE]=test2 |
Где
- TASKID=11 — id задачи
- FIELDS[TITLE]=test2 — название элемента чек листа
Пример запроса для создания новой задачи с чек-листом. Для этого, нужно воспользоваться методом batch (выполнение пакета запросов), так как нам нужно последовательно выполнить как минимум 2 запроса: 1 — создать задачу, 2 — добавить один элемент чек-листа.
1 | https://b24-adminblog.bitrix24.ua/rest/1/yi4qds45455aaq3nyjq1r/batch.json?halt=0&cmd[task_create]=tasks.task.add%3Ffields%255BTITLE%255D%3Dtestbatch%26fields%255BRESPONSIBLE_ID]=1&cmd[chek_list_create]=task.checklistitem.add?TASKID=%2524result%255Btask_create%255D%255Btask%255D%255Bid%255D%26FIELDS%255BTITLE%255D=test2 |