Описание REST API

Авторизация, методы, примеры работы в API ALFACRM

Содержание

REST API в Альфа CRM


Данное описание предназначено для интеграции Альфа CRM с другими информационными сервисами. Мы дополняем этот документ описанием новых методов, моделей и параметров.

Всё взаимодействие через API должно осуществляться по протоколу REST. В качестве формата данных используется JSON. Прочие форматы и протоколы не поддерживаются.

Методы API реализуются в Контроллере (MVC) виде CRUD парадигмы вокруг каждой Модели (MVC). Модель — это отдельная сущность в CRM системе, например Ученик, или Урок, или Филиал под которую реализуется отдельный Контроллер.

Примеры запросов можно посмотреть в приложенных коллекциях Postman

Рекомендации по работе с нашим API:

  1. Создание отдельного пользователя в системе для работы именно с API (особенно актуально, если передаёте информацию с доступами сторонним разработчикам, так как такой доступ всегда можно отключить).
  2. Кеширование токена авторизации (также можно использовать обработку ошибок, чтобы, как только придет ошибка с кодом 401, снова делать запрос на получение токена).
  3. Обработка запросов последовательно:
    • сделайте запрос по API;
    • дождитесь ответа;
    • разберите полученные данные;
    • определитесь, нужно ли отправлять следующий запрос.
  4. Сохранение результатов запросов, чтобы не выгружать одни и те же данные.

Важно! Максимальное количество обращений запросов к API - 5 запросов в секунду для любых методов.

По вопросам работы с нашим API можно написать на почту dev@alfacrm.pro. Ответ может занять до 3-5 рабочих дней.


Авторизация


Данные для авторизации можно найти в настройках профиля.

Наведите курсор на правый верхний угол в системе, появится контекстное меню, выберите раздел «Мой профиль».



Скопируйте данные для авторизации из полей «E-mail» и «Ключ API (v2api)».



Прежде чем обращаться к методам CRUD необходимо авторизоваться и получить временный токен. Этим токеном должен подписываться каждый CRUD запрос заголовке X-ALFACRM-TOKEN. Время жизни токена — 3600 секунд. Для получения токена нужно обратиться методом POST к URI /v2api/auth/login, а в теле запроса передать JSON объект с ключами email и api_key.

Авторизующийся пользователь должен иметь роль с предоставленным доступом к модулю v2api. Иначе запросы к CRUD будут возвращать исключение Access Denied. 

Пример из командной строки Linux (утилита curl):
$ curl -i -X 'POST' -d '{"email":"{email}","api_key":"{api_key}"}' 'https://{hostname}/v2api/auth/login'
            
//Пример кода на PHP
$ch      = curl_init();
$data    = ['email' => 'ivan@mail.ru', 'api_key' => '123456'];
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Accept: application/json', 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_URL, 'https://demo.s20.online/v2api/auth/login');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = json_decode(curl_exec($ch), true);
$code   = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (curl_errno($ch))
    throw new \Exception('Curl error');
curl_close($ch);
if ($code !== 200)
    throw new \Exception($result['name'] . ' - ' . $result['message']);
$token = $result['token'];

Варианты ответа сервера:

  • ОК, код ответа 200, в теле — JSON вида {"token":"GENERATED-TOKEN"}
  • исключение, код ответа 4XX, 5XX, в теле — JSON вида {"name":"Forbidden","message":"Not Authorized","code":0,"status":403}

Значение некоторых параметров


  • {hostname} — клиентский идентификатор, являющийся Hostname в URL для доступа в систему. Например, для https://demo.s20.online это demo.s20.online;
  • {branch} — ID филиала, в который происходит обращение;
  • {email} — e-mail пользователя для авторизации в системе;
  • {api_key} — ключ API для авторизации в системе;
  • {token} — токен, полученный при авторизации (см. блок Авторизация);

Примеры возвращаемых значений в


CRUD


  • Метод Index — возвращает JSON вида {"total":2,"count":2,"page":0,"items":[]}, где total — количество записей всего, count — количество записей в текущей коллекции items, page — текущая страница результатов выдачи. В items содержится вся коллекция записей в виде объектов различных моделей.
  • Методы Create и Update — возвращает JSON вида {"success":true,"errors":[],"model":{"id":1,...}}, где success — результат выполнения запроса (true / false), errors — коллекция ошибок если success == false, model — JSON объект Модели с публичными свойствами.
  • Метод Delete — возвращает JSON вида {"success":true,"errors":[]}, где success — результат выполнения запроса (true / false), errors — коллекция ошибок если success == false.

Branch — сущность филиала

Location — сущность локации

POST на /v2api/{branch}/location/create в теле {"name":"New location","is_active":1,"branch_id":1}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '{"name":"New location","is_active":1,"branch_id":1}' 'https://{hostname}/v2api/{branch}/location/create'
Пример на PHP: 
$ch     = curl_init();
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-ALFACRM-TOKEN: {token}', 'Accept: application/json', 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_URL, 'https://{hostname}/v2api/{branch}/location/create');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"name":"New location","is_active":1,"branch_id":1}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = json_decode(curl_exec($ch), true);
$code   = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (curl_errno($ch))
    throw new \Exception('Curl error');
curl_close($ch);
if ($code !== 200)
    throw new \Exception($result['name'] . ' - ' . $result['message']);
var_dump($result);

Room— сущность аудиторий

POST на /v2api/{branch}/room/create в теле {"branch_id":1,"name":"Testing room","weight":0,"color_id":1}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '{"branch_id":1,"name":"Testing room","weight":0,"color_id":1}' 'https://{hostname}/branch/v2api/room/create'
POST на /v2api/{branch}/room/update?id={id} в теле {"name":"Test Room 2"}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '{"name":"Test Room 2"}' 'https://{hostname}/v2api/branch/room/update?id={id}'
id
int
идентификатор
branch_id
int
id филиала
location_id
int
id локации
streaming_id
int
id стрима
color_id
int
цвет аудитории в календаре
name
string(50)
наименование
note
string(50)
полное название аудитории
is_enabled
bool
флаг активности (1 аудитория активна / 0 аудитория отключена)
weight
int
сортировка)

Customer — центральная сущность

POST на /v2api/{branch}/customer/index в теле {"is_study":0,"lead_status_ids":[1],"page":0}
lead_status_ids — поле для фильтрации,is_study — поле для фильтрации 0 - лид, 1 - клиент, 2 фильтрация по клиентам и лидам, page — пейджинация

Важно! При использовании дополнительной фильтрации по статусу клиента или по этапу воронки продаж, фильтр будет работать как логическое "И", а не "ИЛИ" (например, если укажем в теле запроса {"is_study":2,"phone":79900000000,"lead_status_id":1}, в ответ получим только лидов с номером телефона 79900000000 и с соответствующим id этапа воронки продаж 1).
В Body параметры для фильтрации по клиентам "is_study":1: 
{
    age_from // возраст клиента от
    age_to // возраст клиента до
    assigned_id // id ответственного менеджера
    balance_bonus_from // баланс бонусов от
    balance_bonus_to // баланс бонусов до
    balance_contract_from // баланс договора от
    balance_contract_to // баланс договора до
    color // id цвета
    comment // комментарий
    company_id // id юр лица
    created_at_from – дата создания от, string (формат "DD.MM.YYYY")
    created_at_to – дата создания до, string (формат "DD.MM.YYYY")
    customer_ reject_id // id причины отказа
    date_from // дата добавления от, string
    date_to // дата добавления до, string
    dob_from // дата рождения от, string
    dob_to // дата рождения до, string
    employee_id // id ответственного педагога
    first_payment_date_from // дата первой оплаты от, string
    first_payment_date_to // дата последней оплаты до, string
    gender // пол клиента
    group_id // id группы клиента
    id // id клиента
    is_study // состояние клиента ( 0 - лид, 1 - клиент)
    last_attend_date_from // дата последнего посещения от, string (формат "YYYY-MM-DD")
    last_attend_date_to // дата последнего посещения до, string (формат "YYYY-MM-DD")
    lead_source_id // id источника
    legal_name // имя заказчика
    legal_type // тип заказчика(1-физ лицо, 2-юр.лицо)
    lesson_count_from // остаток уроков от
    lesson_count_to // остаток уроков до
    level_id // id уровня знаний
    name // имя клиента
    next_lesson_date_from // дата след.посещения от, string (формат "YYYY-MM-DD")
    next_lesson_date_to // дата след.посещения до, string (формат "YYYY-MM-DD")
    note // примечание
    phone // контакты клиента
    removed // флаг архивности (2 - только архивные, 1 - активные и архивные, 0 – только активные)
    removed_from // дата отправки в архив от
    removed_to // дата отправки в архив, до
    study_status_id // id статуса обучения
    subject_id // id предмета
    tariff_id // id тарифа
    tariff_till_from // дата действия абонемента от
    tariff_till_to // дата действия абонемента до
    updated_at_from – дата внесения последних измененийот, string (формат "DD.MM.YYYY")
    updated_at_to – дата внесения последних изменений до, string (формат "DD.MM.YYYY")
    withGroups:true //активные группы клиента
}
В Body параметры для фильтрации по лидам "is_study":0: 
{
    age_from // возраст клиента от
    age_to // возраст клиента до
    assigned_id // id ответственного менеджера
    color // id цвета
    comment // комментарий
    company_id // id юр лица
    date_from // дата добавления от, string
    date_to // дата добавления до, string
    dob_from // дата рождения от, string
    dob_to // дата рождения до, string
    gender // пол клиента
    group_id // id группы лида
    id // id клиента
    is_study // состояние клиента ( 0 - лид, 1 - клиент)
    lead_reject_id // id причины потери лида
    lead_source_id // id источника
    legal_name // имя заказчика
    legal_type // тип заказчика(1-физ лицо, 2-юр.лицо)
    level_id // id уровня знаний
    name // имя клиента
    next_lesson_date_from // дата след.посещения, от, string (формат "YYYY-MM-DD")
    next_lesson_date_to // дата след.посещения до, string (формат "YYYY-MM-DD")
    note // примечание
    note // примечание, string
    phone // контакты клиента
    removed // флаг архивности (2 - только архивные, 1 - активные и архивные, 0 – только активные)
    removed_from // дата отправки в архив от
    removed_to // дата отправки в архив, до
    subject_id // id предмета
}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '{"is_study":0,"lead_status_id":1,"page":0}' 'https://{hostname}/v2api/{branch}/customer/index'
Пример на PHP: 
$ch     = curl_init();
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-ALFACRM-TOKEN: {token}', 'Accept: application/json', 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_URL, 'https://{hostname}/v2api/{branch}/customer/index');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"is_study":0,"lead_status_id":1,"page":0}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = json_decode(curl_exec($ch), true);
$code   = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (curl_errno($ch))
    throw new \Exception('Curl error');
curl_close($ch);
if ($code !== 200)
    throw new \Exception($result['name'] . ' - ' . $result['message']);
var_dump($result);
id
int
идентификатор
name
string(50)
полное имя
branch_ids
int array
массив идентификаторов филиалов (Branch)
teacher_ids
int array
массив идентификаторов педагогов (Teacher)
is_study
bool
флаг обучения (0 - лид, 1 - клиент)
study_status_id
int
статус обучения (StudyStatus)
lead_status_ids
int array
этап воронки продаж (LeadStatus)
lead_source_id
int
источник (LeadSource)
assigned_id
int
ответственный менеджер (User)
legal_type
int
тип клиента (1 - физ. лицо, 2 - юр. лицо)
legal_name
string(50)
имя заказчика (если физ. лицо)
company_id
int
компания (Company)
dob
date
дата рождения
balance
float
текущий остаток, деньги
paid_lesson_count
int
текущий остаток, занятия
phone
text array
массив с телефонами
email
text array
массив с e-mail
web
text array
массив с сайтами
addr
text array
массив с адресами
note
text
примечание
updated_at
string
дата обновления("DD.MM.YYYY")
created_at
string
дата добавления ("DD.MM.YYYY")
custom_
...
доп. поля (custom_school, custom_range, etc)

Customer-reject — сущность причин отказов клиентов

POST на /v2api/{branch}/customer-reject/index в теле {"page":0}
page — пейджинация

Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '{"page":0}' 'https://{hostname}/v2api/{branch}/customer-reject/index'
POST на /v2api/{branch}/customer-reject/create в теле {"name":"Customer-reject test","is_enabled":1}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '{"name":"Customer-reject test","is_enabled":1}' 'https://{hostname}/v2api/{branch}/customer-reject/create'
POST на /v2api/{branch}/customer-reject/update?id={id} в теле {"name":"Customer-reject test 2"}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '{"name":"Customer-reject test 2"}' 'https://{hostname}/v2api/{branch}/customer-reject/update?id={id}'
id
int
идентификатор
name
string(50)
наименование
is_enabled
bool
флаг активности (1 причина включена / 0 причина отключена)
weight
int
сортировка

Lead-reject — сущность причин отказов лидов

POST на /v2api/{branch}/lead-reject/create в теле {"name":"Lead-reject test","is_enabled":1}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '{"name":"Lead-reject test","is_enabled":1}' 'https://{hostname}/v2api/{branch}/lead-reject/create'
POST на /v2api/{branch}/lead-reject/update?id={id} в теле {"name":"Lead-reject test 2"}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '{"name":"Lead-reject test 2"}' 'https://{hostname}/v2api/{branch}/lead-reject/update?id={id}'
id
int
идентификатор
name
string(50)
наименование
is_enabled
bool
флаг активности (1 причина включена / 0 причина отключена)
weight
int
сортировка

Bonus— сущность бонусов

branch_id
int
id филиала
customer_id
int
id клиента
amount
int
количество бонусов
date
string
дата добавления/списания бонусов
note
string
примечание
calc_balance_bonus
float
полученный результат бонусов
balance_bonus
float
баланс бонусов
type
int
тип списания (1 - списание бонусов, 2 - выдача товара, 3 - компенсация на счет)
commodity_id
int
id товара, указывается при выдаче товара (тип списания 2 - выдача товара)


Group — сущность групп

POST на /v2api/{branch}/group/index в теле {"id":1,"page":0}
page — пейджинация
В Body параметры для фильтрации: 
{
  "ids" // id групп, array[int]
  "id" // id группы, int
  "name" //название группы, string
  "note" // примечание, string
  "customer_name" // имя клиента, string
  "removed" //активность группы(активна 0, все 1, архивна 2), int
  "level_id" // id уровня группы, int
  "status_id"// id статуса группы, int
  "branch_id"// id филиала, int
  "b_date_from"// дата начала действия группы от, date
  "b_date_to" // дата начала действия группы до, date
  "e_date_from" // дата окончания действия группы от, date
  "e_date_to" //  дата окончания действия группы до date
  "teacher_id"// id ответственного педагога, int
  "updated_at_from" // дата внесения последних изменений от, string (формат "DD.MM.YYYY")
  "updated_at_to" // дата внесения последних изменений до, string (формат "DD.MM.YYYY")
  "created_at_from" // дата создания от, string (формат "DD.MM.YYYY")
  "created_at_to" // дата создания до, string (формат "DD.MM.YYYY")
}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '{"customer_id":1,"page":0}' 'https://{hostname}/v2api/{branch}/group/index'
Пример на PHP: 
$ch     = curl_init();
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-ALFACRM-TOKEN: {token}', 'Accept: application/json', 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_URL, 'https://{hostname}/v2api/{branch}/group/index');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"customer_id":1,"page":0}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = json_decode(curl_exec($ch), true);
$code   = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (curl_errno($ch))
    throw new \Exception('Curl error');
curl_close($ch);
if ($code !== 200)
    throw new \Exception($result['name'] . ' - ' . $result['message']);
var_dump($result);

Lesson — сущность урока

POST на /v2api/{branch}/lesson/create
В Body указываются поля для добавления разового урока:

Обязательные поля к заполнению: 
{
  "lesson_date" // дата урока, date (формат: "DD.MM.YYYY")
  "time_from" // время начала урока, datetime (формат: "HH:MM")
  "duration" // длительность урока в минутах, int
  "lesson_type_id" // id типа урока, int
  "subject_id" // id предмета, int
}

Необязательные поля к заполнению: 
{
  "teacher_ids" // id педагога, int array
  "is_confirmed" // подтверждение урока (по умолчанию да (1)), int
  "is_public" // возможна запись онлайн (по умолчанию нет (0)), int
  "note" // комментарий, string
  "topic" // тема, string
  "room_id" // id аудитории, int
  "group_ids" // id группы (для типов уроков с системным типом “Группа или несколько”), int array
  "customer_ids" // id клиента (для типов уроков с системным типом “Лид, клиент или несколько”), int array
  "custom_name" // дополнительные поля, string
}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '' 'https://{hostname}/v2api/{branch}/lesson/create'
Пример на PHP: 
$ch     = curl_init();
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-ALFACRM-TOKEN: {token}', 'Accept: application/json', 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_URL, 'https://{hostname}/v2api/{branch}/lesson/create');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_POSTFIELDS, '');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = json_decode(curl_exec($ch), true);
$code   = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (curl_errno($ch))
    throw new \Exception('Curl error');
curl_close($ch);
if ($code !== 200)
    throw new \Exception($result['name'] . ' - ' . $result['message']);
var_dump($result);
id
int
идентификатор
branch_id
int
id филиала (Branch)
teacher_ids
array[int]
id педагогов
customer_ids
array[int]
id клиентов
group_ids
array[int]
id групп
name
string
название
lesson_type_id
int
id типа урока
subject_id
int
id предмета
regular_id
int
id регулярного расписания
room_id
int
id аудитории
status
int
id статуса
topic
string
тема
date
string
дата
time_from
string
время начала урока
time_to
string
время окончания урока
note
string
комментарий
details
array
детали проведенного урока
updated_at
string
дата обновления ("DD.MM.YYYY")
created_at
string
дата добавления ("DD.MM.YYYY")

CGI — связь клиенты-группы

Subject — предметы обучения

StudyStatus — статусы обучения

LeadStatus — этапы воронки продаж

id
int
идентификатор
name<
string(50)
наименование
is_enabled
bool
флаг активности

LeadSource — источники

Pay — платежи

id
int
идентификатор
branch_id
int
id филиала (Branch)
location_id
int
id локации (Location)
customer_id
int
id клиента (Customer)
pay_type_id
int
id типа платежа (PayType)
pay_account_id
int
id кассы (PayAccount)
pay_item_id
int
id статьи (PayItem)
teacher_id
int
id педагога (Teacher)
commodity_id
int
id товара (Commodity)
document_date
string
дата
income
int
сумма
payer_name
string
плательщик
group_id
int
id группы, к которой привязан платеж
updated_at
string
дата обновления ("DD.MM.YYYY")
created_at
string
дата добавления ("DD.MM.YYYY")
note
string
примечание

Communication — коммуникации

POST на /v2api/{branch}/phone-call в теле {"page":0}
page — пейджинация
В Body параметры для фильтрации: 
{
  "direction" // id направление звонка, может быть либо in (1) либо out (2), int
  "is_success" // id успешность звонка (0 или 1), 
  "local_number" // string локальный номер звонящего / принявшего звонок, string
  "remote_number" // string номер звонящего в случае входящего звонка, или исходящий номер, string
  "record_url" // string ссылка на запись звонка, string
  "date_from" // string дата звонка от, string
  "date_to" // string дата звонка до, string
}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '{"page":0}' 'https://{hostname}/v2api/{branch}/phone-call'

CustomerTariff — получение списка


абонементов клиента

POST на /v2api/{branch}/customer-tariff/delete?id=[id]&customer_id=[id]
id — id абонемента в карточке клиента, customer_id — id клиента
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' 'https://{hostname}/v2api/{branch}/customer-tariff/delete?id=40&customer_id=1'

Discount — сущность скидок

Log — получение списка истории


изменений

id
int
идентификатор
entity
string
сущность
entity_id
int
id сущности
user_id
int
id пользователя
event
string
тип события, int(1 – добавление, 2 – восстановление, 3 - удаление)
fields_old
array
поля "до"
fields_new
array
поля "после"
fields_rel
array
связанные поля
date_time
string
дата (формат DD.MM.YYYY)

RegularLesson — сущность


регулярных уроков

Tariff — сущность абонемента

Task — сущность задач

id
int
идентификатор
company_id
int
id связанной компании
user_id
int
id пользователя, создавшего задачу
assigned_ids
array[int]
id участников задачи
group_ids
array[int]
id прикрепленных групп
customer_ids
array[int]
id прикрепленных клиентов
title
string
заголовок задачи
text
string
текст задачи
is_archive
bool
флаг архивности
is_done
bool
флаг завершенности
is_private
bool
флаг приватности
created_at
string
дата создания
due_date
string
дата дедлайна
done_date
string
дата завершения
priority
int
приоритет (1-низкий, 2 – нормальный, 3 –высокий)

User — сущность пользователей

POST на /v2api/{branch}/user/create в теле {"name":"Test","email":"test@mail.ru","role_ids":[2],"branch_ids":[1]}
Важно! В системе можно создать пользователя только с интерфейсами администрирования или кабинетом педагога.
Важно! При создании пользователя с ролью кабинет педагога обязательно должно быть указано значение для поля teacher_id, должен быть указан id активного педагога из указанных в запросе филиалов.
В Body обязательные поля для создания пользователя в системе: 
{
  "name" // ФИО пользователя, string
  "email" // почта пользователя, string,
  "role_ids" // роль, [array] int
  "branch_ids"// филиал пользователя, [array] int
}
В Body необязательные поля для создания пользователя в системе: 
{
  "phone" // номер телефона пользователя, string
  "gender" // пол (1 - жен, 0 - муж, по умолчанию 1), bool,
  "sip_number" // номер SIP, int
  "pay_account_ids"// доступ в кассы, [array] int
  "inn"// ИНН кассира, int
}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '{"name":"Test","email":"test@mail.ru", "role_ids":[2],"branch_ids":[1]}' 'https://{hostname}/v2api/{branch}/user/create'
POST на /v2api/{branch}/user/update?id={id} в теле {"name":"Rename2"}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: {token}' -d '{"name":"Rename2"}' 'https://{hostname}/v2api/{branch}/user/update?id={id}'
id
int
идентификатор
name
string
ФИО
email
string
почта (email)
phone
string
телефон
gender
bool
пол (1 - жен, 0 - муж)
role_ids
array [int]
роль
priority
int
ранг
branch_ids
array [int]
id филиалов
sip_number
int
номер SIP
avatar_url
string
ссылка на фотографию пользователя
teacher_id
int
id педагога
pay_account_ids
array [int]
доступ в кассы
customer_id
int
id клиента
status
int
статус (0 - заблокирован, 10 - активен)
inn
int
ИНН кассира
last_login
string ("DD.MM.YYYY")
дата последнего входа

Teacher — сущность педагога

POST на /v2api/{branch}/teacher/working-hour в теле {"page":0}
page — пейджинация
В Body параметры для фильтрации: 
{
    "id" // id графика работы педагога, int,
    "location_id" // id локации, в которой работает педагог, int,
    "weekday" // день недели графика работы, int,
    "time_from" // время начала работы (формат "HH:MM"), string,
    "time_to" // время окончания работы (формат "HH:MM"), string,
    "teacher_id" // id педагога, int
}
POST на /v2api/{branch}/teacher/update?id={id} в теле {"note":"text"}
Пример из командной строки Linux (утилита curl): 
$ curl -i -X 'POST' -H 'X-ALFACRM-TOKEN: <strong>{token}</strong>' -d '{"note":"text"}' 'https://<strong>{hostname}</strong>/v2api/<strong>{branch}</strong>/task/teacher?id=<strong>{id}</strong>'
Пример на PHP: 
$ch     = curl_init();
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-ALFACRM-TOKEN: <strong>{token}</strong>', 'Accept: application/json', 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_URL, 'https://<strong>{hostname}</strong>/v2api/<strong>{branch}</strong>/task/teacher?id=<strong>{id}</strong>');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"note":"text"}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = json_decode(curl_exec($ch), true);
$code   = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (curl_errno($ch))
    throw new \Exception('Curl error');
curl_close($ch);
if ($code !== 200)
    throw new \Exception($result['name'] . ' - ' . $result['message']);
var_dump($result);
id
int
идентификатор
branch_ids
array[int]
id филиалов (Branch)
name
string
имя педагога
dob
string
день рождения
gender
int
пол
e_date
string
дата архивации педагога
subject_id
int
id предмета квалификации
subject_name
string
название предмета квалификации
skill_id
int
id квалификации
skill_name
string
название квалификации
note
string
примечание


Поля в модели working-hour

id
int
идентификатор
location_id
int
id локации графика работы (если локация НЕ задана, то стоит параметр null)
weekday
int
день недели графика работы (где 1 - это воскресенье, а 7 - это суббота)
time_from
string
время начала графика работы (формат "HH:MM:SS")
time_to
string
время окончания графика работы (формат "HH:MM:SS")
teacher_id
int
id педагога, которому принадлежит график работы


Поля в модели teacher-rate

id
int
идентификатор
rate
float
значение ставки
type
int
тип ставки (1 - ставка в валюте, 2 – процентная ставка)
teacher_id
int
id педагога, в карточке которого добавлена ставка
b_date
string
начало периода действия ставки (формат "YYYY-MM-DD”)
e_dat
string
конец периода действия ставки (формат "YYYY-MM-DD”)
s_multirate
bool
стоит ли галка напротив пункта “Умножить значение на кол-во посетивших” (0 - нет, 1 – да)
is_proportional
bool
стоит ли галка напротив пункта “Увеличить значение пропорционально длительности” (0 - нет, 1 – да)
condition_attend
int
тип расчета ставки (1 - если выбрано “За посетивших”; 2 - если выбрано “За пропустивших по причине”; 3 - если выбрано “За посетивших или пропустивших по при)а
reason_ids
array
id причин пропуска (если причины пропуска НЕ заданы, то стоит параметр null)
count_from
int
кол-во клиентов “от” в ставке (если поле НЕ заполнено, то стоит параметр null)
count_to
int
кол-во клиентов “до” в ставке (если поле НЕ заполнено, то стоит параметр null)
duration
int
длительность урока в ставке (если поле НЕ заполнено, то стоит параметр null)
lesson_type_ids
array
id типов уроков в ставке
subject_ids
array
id предметов в ставке
is_gt_zero
bool
стоит ли галка напротив пункта “Начислять, если списание за урок у клиента более 0” (0 - нет, 1 – да)


Поделиться

Empty

По вашему запросу ничего не найдено

Перейти

Навигация

Esc

Закрыть