bloodlog / webinar-client
webinar.ru的PHP客户端
1.0.4
2022-08-18 09:38 UTC
Requires
- php: ^7.4|^8.0
- ext-json: *
- guzzlehttp/guzzle: ^6.2|^7.0.1
Requires (Dev)
- orchestra/testbench: 6.*
- phpunit/phpunit: ^8.4
This package is auto-updated.
Last update: 2024-09-18 14:24:27 UTC
README
Laravel集成客户端
composer require bloodlog/webinar-client
连接
- 发布配置
php artisan vendor:publish --provider="Bloodlog\WebinarClient\Providers\WebinarClientProvider"
如果自动注册不工作,可以在config/app.php中配置客户端以注册提供者
'providers' => [ Bloodlog\WebinarClient\Providers\WebinarClientProvider::class, ]
- 获取API令牌以访问webinar.ru并将其添加到配置中
- config/webinar.php
'token' => 'Enter your api token', //
获取密钥请在此处
- https://events.webinar.ru/business/api - 密钥
- https://help.webinar.ru/ru/articles/3147750-интеграция-api-с-чем-начать - 文档
注册用户参加网络研讨会
1 查询网络研讨会
use Bloodlog\WebinarClient\WebinarClient; $client = new WebinarClient(); $webinars = $client->events()->webinarsRequest(); // получаем все вебинары // Здесь нам нужно найти нужный вебинар и взять у него eventSessions -> id // Или можно воспользоваться полезным запросом ниже
或者使用更方便的方法助手
use Bloodlog\WebinarClient\WebinarClient; $client = new WebinarClient(); $webinars = $client->events()->webinarsList(); // получаем только eventSessionId и имя вебинара // Response:[ // 'id' => 123, // $eventSession->id, // 'name' => 'Новый вебинар', // $eventSession->name, //]
2 查询eventSessionID密钥并获取additionalFields(注册字段): (如果没有additionalFields,可以跳过)
$client = new WebinarClient(); $eventSessionId = 123; $webinars = $client->events()->eventSessions($eventSessionId); /* Получаем список полей и сохраняем ключи полей. Ключи нужно использовать при регистрации пользователей. Response:{ "id": 123, "name": "Новое мероприятие сегодня", "additionalFields": [ { "key": "cea75f8cd36a4f8567d5068b7e7e05e8", "label": "referrer", "type": "text", "isRequired": true } ], } */
3 发送注册请求(再次使用步骤1中的$eventSessionId)
$client = new WebinarClient(); $data = [ 'email' => 'example@example.ru', 'name' => 'Иван', 'secondName' => 'Иванов', 'additionalFields' => [ '62899cefc8855544723baae88cbfce9c' => 'Иванович', '62899cefc8855544723baae88cbfce2c' => 'IBM', ], 'role' => 'GUEST', 'isAutoEnter' => true, 'sendEmail' => false, ]; $webinars = $client->registration()->registerRequest($eventSessionId, $data); // Response: {"participationId":123,"link":"https:\/\/events.webinar.ru\/Test\/9232275\/46a222712a0466960b1bf3a432c22054","contactId":654}
或者使用更方便的方法助手
使用长且不便的键发送additionalFields不方便,所以我通过配置和转换器方法去掉了它们
1 在配置中注册additionalFields键: 使用键匹配,左边是网络研讨会的键,右边是你的键
- config/webinar.php
'api' => [ 'registration' => [ 'form-transform' => [ // webinar.ru использует ключи вместо наименования полей. После получения ключей для регистрации нужно сопоставить поля 'additionalFields' => [ '62899cefc8855544723baae88cbfce9c' => 'last_name', // Сопоставление по которому будет произведена замена '62899cefc8855544723baae66cbfce2c' => 'company', // Сопоставление по которому будет произведена замена ], ], ], ],
2 接下来只需使用自己的字段名
$client = new WebinarClient(); $data = [ 'email' => 'example@example.ru', 'name' => 'Иван', 'secondName' => 'Иванов', 'additionalFields' => [ 'last_name' => 'Иванович', // Замена на обратный ключ произойдёт внутри метода. 'company' => 'IBM', // Замена ], 'role' => 'GUEST', 'isAutoEnter' => true, 'sendEmail' => false, ]; $webinars = $client->registration()->registerRequest($eventSessionId, $data); // Response: {"participationId":123,"link":"https:\/\/events.webinar.ru\/Test\/9232275\/46a222712a0466960b1bf3a432c22054","contactId":654}
有关更多信息,请参阅官方文档