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

bitrix24-php-sdk (unofficial)

Пользователь 14686 -> Всем, Академия 1С-Битрикс выпускников

11 Январь, 2014 1:03

В одном из моих личных проектов потребовалось сделать приложение 2 типа для bitrix24 и работать с его API.
Я человек ленивый, поэтому решил написать «простенькую» обёртку поверх REST- вызовов.

Библиотека живёт на github — https://github.com/mesilov/bitrix24-php-sdk

Пример получения текущего юзера

// инициализируем бибилиотеку для работы с B24
$obB24App = new \Bitrix24\Bitrix24();
$obB24App->setApplicationScope($arParams['B24_APPLICATION_SCOPE']);
$obB24App->setApplicationId($arParams['B24_APPLICATION_ID']);
$obB24App->setApplicationSecret($arParams['B24_APPLICATION_SECRET']);
 
// выставляем настройки, зависящие от пользователя
$obB24App->setDomain($arParams['DOMAIN']);
$obB24App->setMemberId($arParams['MEMBER_ID']);
$obB24App->setAccessToken($arParams['AUTH_ID']);
$obB24App->setRefreshToken($arParams['REFRESH_ID']);

// получили информацию по текущему пользователю из Bitrix24
$obB24User = new \Bitrix24\User\User($obB24App);
$arCurrentB24User = $obB24User->current();

Пример получения списка задач

/**  
* объект для работы с задачами 
**/  
$obTasks = new \Bitrix24\Task\TaskItems($obB24App);  
 
/**
* список задач из B24
* @var $arB24Tasks array */
$arB24Tasks = $obTasks->getList( 
   array("ID" => 'desc'),  
   array('RESPONSIBLE_ID' => $arUser['B24_USER_ID']), 
   array('ID','TITLE','CREATED_DATE','DEADLINE','STATUS','REAL_STATUS','STATUS_CHANGED_DATE','GROUP_ID','CHANGED_DATE'), 
   null);

Я её периодически обновляю, но уже сейчас она вполне пригодна для работы.
Критика и пулл-реквесты приветствуются.

Теги:

bitrix24

33 Комментировать

Комментарии: 21 21 0

Ещё 1224

Предыдущие комментарии 1

Загальский Андрей

Пользователь 87386 11 Январь, 2014 19:23

Шикарно!!!, ваша библиотека натолкнула на мысль сделать модуль (импорт текущих задач по проекту), и ставить на сайты клиентам. Этакий онлайн контроль выполнения задачи

. И по всей видимости довольно легко можно сделать, чтобы и сам клиент ставил задачи.
Правда придется сделать некий промежуточный апи, чтобы не палить секретке...

2 Ответить Ещё

Kriachek Mikhail

Пользователь 9700 12 Январь, 2014 3:00

Хорошая штука получилось, однако, надо же повредничать =)

1) приведите имена API к общему виду, ибо почему для User это get, а для задач getList, хотя делают одно и тоже. Аналогично регистр, в SonetGroup есть Get
2) думаю для getList стоит использовать подход как в новом ядре битрикса, т.е. массив параметров

xxx::getList(array(
  'sort' => ...
   'filter' => ...
))

Немного "попилить" еще и будет очень достойное API.

3 Ответить Ещё

Загальский Андрей

Пользователь 87386 12 Январь, 2014 12:02

Kryachek Mikhail, так в апи он также user.get .

0 Ответить Ещё

Kriachek Mikhail

Пользователь 9700 12 Январь, 2014 14:36

Андрей Загальский так в этом и смысл, чтобы название и параметры функций привести к общему виду, а не кашу, что существует сейчас

1 Ответить Ещё

Задойный Алексей

Пользователь 37620 12 Январь, 2014 15:42

блин, бесит - не могу лайкнуть пост 2й день.
Причём судя по количеству лайков не я один...

2 Ответить Ещё

Месилов Максим

Пользователь 14686 22 Март, 2014 13:29

Kryachek Mikhail, у вас была возможность сделатьREST-API с чистого листа. Что там под капотом, никого бы не интересовало бы.

0 Ответить Ещё

Месилов Максим

Пользователь 14686 22 Март, 2014 13:31

Добавил работу с Лидами в CRM.

Теперь если на сайтепроисходит финансово-значимое событие, то лид уходит в CRM.
Да, я в курсе про обмен заказами и на уровне веб-форм. Но есть ещё младшие редакции

      $obLead = new \Bitrix24\CRM\Lead($this->b24App);
      $arNewLead = array(
         'TITLE'               => 'tCRM new user - '.$this->arResult["B24_USER"]['NAME'],
         'NAME'               => $this->arResult["B24_USER"]['NAME'],
         'SECOND_NAME'         => $this->arResult["B24_USER"]['SECOND_NAME'],
         'LAST_NAME'          => $this->arResult["B24_USER"]['LAST_NAME'],
         'STATUS_ID'          => 'NEW',
         'OPENED'             => 'YES',
         'ASSIGNED_BY_ID'       => '1',
         'CURRENCY_ID'          => 'RUB',
         'OPPORTUNITY'          => '500',
         'EMAIL'             => $this->arResult["B24_USER"]['EMAIL'],
         'SOURCE_DESCRIPTION'    => $this->arResult["B24_USER"]['EMAIL'],
         'COMMENTS'             => $this->arResult["B24_USER"]['EMAIL'],
      );
      $obLead->add($arNewLead);

1 Ответить Ещё

Месилов Максим

Пользователь 14686 4 Ноябрь, 2014 23:31

Коллеги, добрый вечер.
Обновил библиотеку:
1. Добавил класс для работы со счетами Invoice. Огромное спасибо Максим Сидоренко, Григорий Заводов, Бурков Георгий
2. Для классов стал добавлять классы-пресеты с полями для облегчения разработки через IDE Bitrix24\Presets\CRM\Invoice

// классы Bitrix24-sdk-php
use \Bitrix24\CRM\Invoice as B24Invoice;
use \Bitrix24\Presets\CRM\Invoice\Fields as B24InvoiceFields;
...
$arContact = $obContact->getList(array(),array(
   B24ContactFields::ORIGINATOR_ID => 'mesilov.yamoney',
   B24ContactFields::ORIGIN_ID => 'mesilov.yamoney.contact',
));

C IDE стало работать ещё удобнее, буду постепенно добавлять для всех сущностей.

3. Добавил пресеты для класса Contact

2 Ответить Ещё

Месилов Максим

Пользователь 14686 24 Июнь, 2015 12:51

Добрый вечер. Обновил библиотеку
https://github.com/mesilov/bitrix24-ph.../tag/0.2.0

add class Deal
add class LiveFeedMessage
add task fields presets
add Bitrix24\CRM\Lead entity
add some event fields in presets
add Bitrix24\CRM\Contact entity
add class Bitrix24\Task\ChecklistItem
add class Bitrix24\Task\CommentItem
add class Bitrix24\Task\ElapsedItem
add class Bitrix24\Task\Item
add class Bitrix24\Task\Items
changed PHP version for Composer
fixed bug in Bitrix24\Presets\CRM\Lead
fixed bug in class Invoice
remove class Bitrix24\Task\TaskItems будет работать Bitrix24\Task\Items
remove class Bitrix24\Task\TaskItem будет работать Bitrix24\Task\Item

4 Ответить Ещё

Коваленко Алексей

Пользователь 10337 17 Ноябрь, 2016 6:38

Максим Месилов, ты в sdk не зашивал уже сразу возможность логирования всех запросов на bitrix24 ?

0 Ответить Ещё

Лядов Максим

Пользователь 735467 27 Июнь, 2017 15:16

Здравствуйте, Максим!

Прежде всего, хочу сказать большое спасибо за bitrix24-php-sdk. Очень полезная вещь, позволяет значительно сократить разработку приложений.

Недавно я столкнулся с проблемой пакетного вызова REST API при использовании данного SDK.

Почему-то в пакете оказывались не все запросы при одинаковых исходных данных. Причем запросы выпадали случайным образом. В log-файле убедился, что они действительно выпадают при формировании curl-запроса.

В итоге нашел источник проблемы. В файле bitrix24.php есть функция addBatchCall, в которой пакет формируется как массив. А для определения ключа массива $this->_batch[$id] используется функция uniqid().

    public function addBatchCall($method, array $parameters = array(), callable $callback = null)
    {
        $id = uniqid();
        $this->_batch[$id] = array(
            'method' => $method,
            'parameters' => $parameters,
            'callback' => $callback,
        );
        return $id;
    }

На сервере (Linux) все происходит без проблем, однако на локальной машине (Windows) эта функция, как я понимаю, генерирует выходное значение, основываясь не на микросекундах, а на миллисекундах. Проверял, действительно так.

Конечный вариант естественно будет работать, но хотелось бы избежать подобных проблем в процессе разработки. Мне очень повезло, что я относительно быстро нашел ошибку, а так можно долго перепроверять свой код, пытаясь найти сбежавшие запросы

Настоятельно рекомендую Вам изменить способ формирования $id, есть множество различных способов.

Заранее благодарю!

1 Ответить Ещё

Месилов Максим

Пользователь 14686 28 Июнь, 2017 14:17

Лядов Максим, положите пожалуйста текст на https://github.com/mesilov/bitrix24-ph...sdk/issues

0 Ответить Ещё

Пупкн Вася

Пользователь 1746711 8 Февраль, 2018 12:38

Месилов Максим, Подскажите пожалуйста

$obB24App->setApplicationScope($arParams['B24_APPLICATION_SCOPE']);$obB24App->setApplicationId($arParams['B24_APPLICATION_ID']);
$obB24App->setApplicationSecret($arParams['B24_APPLICATION_SECRET']);

$obB24App->setDomain($arParams['DOMAIN']);
$obB24App->setMemberId($arParams['MEMBER_ID']);
$obB24App->setAccessToken($arParams['AUTH_ID']);
$obB24App->setRefreshToken($arParams['REFRESH_ID']);

где их брать ?

7 Ответить Ещё

Пустоутов Алексей

Пользователь 2249363 15 Декабрь, 2018 20:34

Особенно
$obB24App->setDomain($arParams['DOMAIN']);
$obB24App->setMemberId($arParams['MEMBER_ID']);
$obB24App->setAccessToken($arParams['AUTH_ID']);
$obB24App->setRefreshToken($arParams['REFRESH_ID']);

И об этом ни слова)) Как партизаны все молчат. А блин так не хочется ковырять и смотреть что внутри библиотеки... Чует мое сердце прийдется))

1 Ответить Ещё

Дмитрий

Пользователь 31 Август, 2019 9:02

Пожалуйста, опишите методы setApplicationId, setApplicationSecret, setDomain, setAccessToken и т.д. Совершенно непонятно, что в них передавать.

0 Ответить Ещё

Булгаков Никита

Пользователь 73078 15 Сентябрь, 2019 19:00

Notice: Undefined index: Location in /home/bitrix/www/local-server-ui-index/vendor/ujy/bitrix24_api_authorization/src/bitrix24Authorization.php on line 29
THERE IS NO ~bitrix_sessid~ IN CURL ANSWER...
INPUT CURL BODY:

Подскажите, в чём может быть проблема?

0 Ответить Ещё

Евгений

Пользователь 18 Ноябрь, 2019 16:36

Проблема в том, что битрикс сменил UI авторизации и моя библиотека перестала работать. До момента, пока не переписал её под новый UI...
У Вас если происходят ошибки - смотрите адрес скрипта где эта ошибка произошла и задавайте вопрос в ISSUES на гитхабе разработчику библиотекы

0 Ответить Ещё

Евгений

Пользователь 18 Ноябрь, 2019 16:37

Булгаков Никита Проблема в том, что битрикс сменил UI авторизации и моя библиотека перестала работать. До момента, пока не переписал её под новый UI...
У Вас если происходят ошибки - смотрите адрес скрипта где эта ошибка произошла и задавайте вопрос в ISSUES на гитхабе разработчику библиотекы

0 Ответить Ещё

Гонюков Роман

Пользователь 1890127 24 Март, 2020 9:51

Пустоутов Алексей,

$obB24App->setApplicationScope($arParams['B24_APPLICATION_SCOPE']);$obB24App->setApplicationId($arParams['B24_APPLICATION_ID']);
$obB24App->setApplicationSecret($arParams['B24_APPLICATION_SECRET']);

$obB24App->setDomain($arParams['DOMAIN']);
$obB24App->setMemberId($arParams['MEMBER_ID']);
$obB24App->setAccessToken($arParams['AUTH_ID']);
$obB24App->setRefreshToken($arParams['REFRESH_ID']);

где их брать ?

в переменной $_REQUEST эти данные передаются

0 Ответить Ещё

Гонюков Роман

Пользователь 1890127 24 Март, 2020 9:54

Месилов Максим, есть более подробная документация по вашему sdk?
Не по rest api в целом (тут всё понятно), а именно по вашей библиотеке?

И есть ли у вас методы для работы с batch?

2 Ответить Ещё

Группы на сайте создаются не только сотрудниками «1С-Битрикс», но и партнерами компании. Поэтому мнения участников групп могут не совпадать с позицией компании «1С-Битрикс».

bitrix24-php-sdk (unofficial)

Продукты

Управление сайтом

Битрикс24

Интернет-магазин + CRM

Решения

Для интернет-магазинов

Каталог готовых решений

Внедрение

Выбрать партнера

Проверить партнера

Стать партнером