Cara menyediakan sambungan

Pertama, anda perlu mendapatkan kunci API. Anda boleh menemuinya di bahagian Profil dalam akaun peribadi anda di MyOwnConference

Selepas menyalin kunci, buka Tetapan -> Pemalar projek pada Mavibot dan tampalkannya dalam pembolehubah myownconference_api_key:

Setiap fungsi mengembalikan kamus yang mempunyai parameter status; nilainya boleh menjadi 0 dan 1.

Jika status=1 maka permintaan dalam MyOwnConference berjaya dan parameter result akan mengandungi hasil permintaan, seperti:

{'status': '1', 'result': [{'name': 'Super web', 'alias': 'csml-sjgf-cnjp-clkw', 'start': '2022-02-12 00:00:00'}]}

atau permintaan berjaya, tetapi tiada apa yang ditemui:

{'status': '1', 'result': []}

Jika status=0 maka terdapat masalah dan penerangan akan disimpan dalam error, seperti:

{"status":"0","error":"Webinar dengan alias "wenk-gjkc-teqp-nteh" tidak aktif"} {'status': '0', 'error': 'Pembolehubah yang diperlukan hilang - email'}

Cara mencari webinar

Fungsi myownconference_find_webinars(date, status) digunakan untuk mencari webinar, di mana

date - tarikh dalam format dd.mm.yyyy - memilih webinar untuk tarikh tertentu
status - nilai 1 untuk webinar aktif atau akan datang, 0 untuk yang telah tamat

myownconference_find_webinars() - mengembalikan tatasusunan semua webinar yang ditemui

Fungsi ini mengembalikan kamus seperti berikut:

Jika berjaya (contoh):

{'status': '1', 'result': [{'name': 'Super web', 'alias': 'csml-sjgf-cnjp-clkw', 'start': '2022-02-12 00:00:00'}]}

Jika tidak berjaya (contoh):

{"status":"0","error":"Format tidak disokong atau tarikh tidak sah. Parameter mesti dalam format yyyy-mm-dd"}

Cara menyemak sama ada pengguna hadir dalam webinar aktif

Fungsi myownconference_is_online_user(webinar_id, email), di mana:

webinar_id - id webinar, atau dengan kata lain, nilai “alias” daripada permintaan semasa mencari webinar
email - alamat e-mel pengguna, jika tidak dikongsi, maka e-mel daripada pembolehubah email akan digunakan, jika ada

Hasil jika fungsi berjaya:

{"status":"1","result":true} - pengguna hadir pada masa ini dalam webinar {"status":"1","result":false} - pengguna tidak hadir

Hasil jika terdapat ralat dalam permintaan:

{"status":"0","error":"Webinar dengan alias "serg-dhpq-mznf-fwcb" tidak aktif"}

Cara mendapatkan data sejarah pengguna

Fungsi myownconference_history_user(webinar_id, email), di mana

webinar_id - id webinar, atau dengan kata lain, nilai “alias” daripada permintaan semasa mencari webinar
email - alamat e-mel pengguna, jika tidak dikongsi, maka e-mel daripada pembolehubah email akan digunakan, jika ada

Hasil jika berjaya:

Dalam parameter result akan terdapat tatasusunan dengan data pengguna

{'status': '1', 'result': ['John Smith', '[email protected]', 'ua', '12:02:45', '12:12:15', 'G', '28%']} {"status":"1","result":false} - pengguna tidak ditemui

Sekiranya gagal:

{'status': '0', 'error': 'Pembolehubah yang diperlukan hilang - email'} - e-mel tidak dikongsi dan tidak ditemui dalam pembolehubah email

Contoh permintaan dan mendapatkan nama pengguna:

Contoh permintaan untuk mendapatkan data sejarah pengguna

Contoh hasil permintaan

Cara menyemak sama ada pengguna berada dalam senarai semua peserta

Fungsi myownconference_is_our_user(email), di mana:

email - alamat e-mel pengguna, jika tidak dikongsi, maka e-mel daripada pembolehubah email akan digunakan, jika ada

Hasil jika berjaya:

{"status":"1","result":true} - pengguna berada dalam pangkalan data anda {"status":"1","result":false} - tiada pengguna sedemikian dalam pangkalan data anda

Jika tidak berjaya:

{'status': '0', 'error': 'Pembolehubah yang diperlukan hilang - email'} - e-mel tidak dikongsi dan tidak ditemui dalam pembolehubah email

Cara mencipta peserta

Fungsi ini menambah peserta webinar ke senarai semua pengguna. Selepas penciptaan berjaya, pengguna ini boleh didaftarkan ke webinar (lebih lanjut di bawah)

Fungsi myownconference_add_user(email), di mana:

email - alamat e-mel pengguna, jika tidak dikongsi, maka e-mel daripada pembolehubah email akan digunakan, jika ada

Hasil jika berjaya:

{"status":"1","result":true} - pengguna telah ditambahkan ke senarai semua peserta anda

Jika tidak berjaya:

{'status': '0', 'error': 'Pembolehubah yang diperlukan hilang - email'} - e-mel tidak dikongsi dan tidak ditemui dalam pembolehubah email.

Cara mendaftarkan peserta ke webinar

Adalah wajib untuk meminta e-mel pelanggan untuk pendaftaran berlaku. Apa-apa lagi adalah pilihan.

Fungsi myownconference_add_user_to_webinar(webinar_id, email), di mana

webinar_id - id webinar, atau dengan kata lain, nilai “alias” daripada permintaan semasa mencari webinar
email - alamat e-mel pengguna, jika tidak dikongsi, maka e-mel daripada pembolehubah email akan digunakan, jika ada

Hasil jika berjaya:

{"status":"1","result":true} - pengguna telah didaftarkan ke webinar

Jika tidak berjaya:

{"status":"0","error":"Webinar dengan alias "serg-dhpq-mznf-fwcb" tidak aktif"}