bloodlog/webinar-client

webinar.ru的PHP客户端

1.0.4 2022-08-18 09:38 UTC

This package is auto-updated.

Last update: 2024-09-18 14:24:27 UTC


README

Laravel集成客户端

composer require bloodlog/webinar-client

连接

  1. 发布配置
php artisan vendor:publish --provider="Bloodlog\WebinarClient\Providers\WebinarClientProvider"   

如果自动注册不工作,可以在config/app.php中配置客户端以注册提供者

'providers' => [
    Bloodlog\WebinarClient\Providers\WebinarClientProvider::class,
]
  1. 获取API令牌以访问webinar.ru并将其添加到配置中
  • config/webinar.php
 'token' => 'Enter your api token', // 

获取密钥请在此处

注册用户参加网络研讨会

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}

有关更多信息,请参阅官方文档