Разработчикам

Методы API

Формат вызова

Адрес для вызова http://corpfamilybot.ru/bot/family/api/v1.php

К адресу всегда добавляется GET параметр key

Значение параметра можно узнать в админке бота на странице "Настройки", параметр "Ключ для интеграции с API"

Добавить пользователя

Параметры

Обязательные:
key = API_KEY
method = user_new
company_guid = id вашей компании (Берется из параметра в ссылке на присоединение новых сотрудников)
user_id = id пользователя telegram
first_name = имя
last_name = фамилия
nickname = nickname пользователя в телеграм
second_name = фамилия
user_phone = телефон(7хххххххххх)
user_email = почта
is_manager = 1/0 (Руководитель или нет)

Необязательные:
user_guid = id пользователя во внешней системе (используется для связки с другими системами)sms = нужно ли отправлять пользователю приветственную смс (true/false)
user_birthday = день рождения (хх.хх.хххх)
user_photo = ссылка на фото
manager_id = id руководителя в телеграм (по умолчанию создатель компании в боте)

Получить список пользователей

Параметры

key = API_KEY
method = user_list
user_id = id пользователя от которого выполняется запрос

Закрыть задачу

Параметры

key = API_KEY
method = close_task
guid = id задачи
user_id = id пользователя инициатора закрытия

Перенести дедлайн

Параметры

key = API_KEY
method = change_deadline
guid = id задачи
user_id = id пользователя инициатора переноса дедлайна
deadline = новый дедлайн (2019-10-04)

Получить список задач

Параметры

key = API_KEY
method = task_list
user_id = id пользователя от которого выполняется запрос

Получить список Кайдзен

Параметры

key = API_KEY
method = kaidzen_list
user_id = id пользователя от которого выполняется запрос

Поставить задачу

Параметры

key = API_KEY
method = new_task
user_id = id постановщика в telegram
to_id = id ответственного в telegram
text = текст задачи в urlencode
deadline = дедлайн по задаче (2019-10-04), если без определенного срока, то 0000-00-00