Bölüm 5 GET POST

end – Toplantıyı Sonlandır

end uç noktası, çalışmakta olan bir BigBlueButton toplantısını hemen sonlandırır. Tüm katılımcılar konferanstan çıkarılır ve kayıt etkinleştirilmişse kayıt işleme hattı otomatik olarak tetiklenir.

Uç Nokta

GET/POST https://api-guide.bbbserver.com/bigbluebutton/api/end?<parameter>&checksum=replace-with-checksum

Hem GET hem de POST yöntemleri desteklenir. POST kullanırken, parametreleri istek gövdesinde application/x-www-form-urlencoded olarak gönderin.

Gerekli Parametreler

Parametre Tür Açıklama
meetingID String Gerekli. Sonlandırılacak toplantının toplantı kimliği. Toplantı oluşturulurken kullanılan kimlikle eşleşmelidir.

İsteğe Bağlı Parametreler

Parametre Tür Açıklama
password String Deprecated Moderatör parolası. Bu parametre BigBlueButton 3.0 tarihinden beri artık gerekli değildir — kimlik doğrulama için yalnızca checksum yeterlidir.

Örnek İstek

POST ile cURL İsteği

curl --request POST \
    --url "https://api-guide.bbbserver.com/bigbluebutton/api/end" \
  --header "Content-Type: application/x-www-form-urlencoded" \
    --data "meetingID=replace-with-meeting-id&checksum=replace-with-checksum"

Örnek Yanıt

Başarılı

<response>
  <returncode>SUCCESS</returncode>
  <messageKey>sentEndMeetingRequest</messageKey>
  <message>A request to end the meeting was sent. Please wait a few seconds,
    and then use the getMeetingInfo or isMeetingRunning API calls to verify
    that it was ended.</message>
</response>

Hata — Toplantı Bulunamadı

<response>
  <returncode>FAILED</returncode>
  <messageKey>notFound</messageKey>
  <message>We could not find a meeting with that meeting ID.</message>
</response>

bbbserver.de Notları

bbbserver.de: create çağrısındaki duration parametresi, üzerinde toplantıları otomatik olarak sonlandırmaz. Toplantıyı belirli bir sürenin sonunda bitirmeniz gerekiyorsa, istenen anda endbbbserver.de API çağrısını manuel olarak göndermelisiniz (örneğin, uygulamanızda bir zamanlayıcı veya aracılığıyla).

Önemli Davranış

end çağrısı asenkrondur. Yanıt, isteğin alındığını doğrular; toplantının tamamen sonlandığını değil. Kapanma sürecinin tam zamanlaması resmî olarak belirtilmemiştir.

Sunucuya end API çağrısını gönderin.

Toplantının kapanması için birkaç saniye bekleyin.

getMeetingInfo veya isMeetingRunning çağrısı yaparak toplantının sona erdiğini doğrulayın.

İpuçları

create sırasında meta_endCallbackUrl parametresini ayarlarsanız, toplantı sona erdiğinde BigBlueButton belirttiğiniz URL'ye bir callback gönderir. Bunu toplantı sonrası iş akışlarını otomatik olarak tetiklemek için kullanın.

  • Kayıt etkinse, toplantı sona erdikten sonra kayıt işleme otomatik olarak başlar.
  • Sonlandırılmış bir toplantı devam ettirilemez — yeni bir toplantı oluşturmanız gerekir.
  • BigBlueButton 3.0 tarihinden beri password parametresi artık gerekli değildir. checksum yeterli kimlik doğrulaması sağlar.

Sıkça Sorulan Sorular

Tüm katılımcılar hemen konferanstan çıkarılır. Toplantının bir moderatör veya yönetici tarafından sonlandırıldığına dair bir bildirim görürler.

Hayır. Bir toplantı sonlandırıldıktan sonra devam ettirilemez. create API çağrısını kullanarak yeni bir toplantı oluşturmanız gerekir. İsterseniz aynı meetingID değerini yeniden kullanabilirsiniz.

Hayır. BigBlueButton 3.0 tarihinden beri password parametresi kullanımdan kaldırılmıştır ve artık gerekli değildir. Kimlik doğrulama için checksum yeterlidir. Eski sürümler hâlâ moderatör parolasını gerektirebilir.

end çağrısı asenkrondur. Yanıt genellikle milisaniyeler içinde dönse de, gerçek kapanma süreci birkaç saniye sürebilir. Tam zamanlama resmî olarak belirtilmemiştir. Doğrulamak için getMeetingInfo veya isMeetingRunning kullanın.

Toplantı için kayıt etkinleştirildiyse, toplantı sona erdiğinde kayıt işleme hattı otomatik olarak tetiklenir. İşleme tamamlandıktan sonra kayıt kullanılabilir hale gelir; bu, toplantının uzunluğuna bağlı olarak birkaç dakika sürebilir.