MP4/webm API

You can request to process your recording to MP4 using API. Here we did extended BBB API. So, you'll require to follow same procedure as you are doing for BBB API. You can find details from here: https://docs.bigbluebutton.org/dev/api.html#usage

Here 2 extra API methods for this purpose:

1) processMP4

2) downloadMP4

 

1) processMP4

First of all you'll require to send process request to process MP4 file. You can request up to 2 requests at a same time. After that need to wait until those 2 will finish process.

Resource URL:

http://api.mynaparrot.com/bigbluebutton/XXXX/api/processMP4?[parameters]&checksum=[checksum]

Parameters:

Param Name Required/Optional Type Description
recordID Required String The record ID which you want to convert into MP4.
mp4ReadyUrl Optional String

The callback URL in which our system will send POST request when the MP4 processing will be finish

 

Example Requests:

https://api.mynaparrot.com/bigbluebutton/XXXX/api/processMP4?recordID=4186dd8cc41f1e8af5e0cdc1c643632f483a97af-1586841706589&mp4ReadyUrl=https%3A%2F%2Fmywebsite.com%2FbbbMP4.php&checksum=fa24b14fe70e34173f4b425cef140614812de7b4

Example Response:

<response>
  <returncode>SUCCESS</returncode>
  <messageKey>processing</messageKey>
<message>Your request in progress. You'll receive email notification once done.</message> </response>

 If you have sent mp4ReadyUrl value then our system will send in that URL a POST request including recordId & mp4Link. Remember, the URL given as mp4Link will remain valid for 2 hours only but you can generate the link again using downloadMP4 API call.

2) downloadMP4

When the file will be ready that time you can send request for download. Remember, the download link will remain valid for 2 hours only but you can generate link again using this same API call.

Resource URL:

http://api.mynaparrot.com/bigbluebutton/XXXX/api/downloadMP4?[parameters]&checksum=[checksum]

Parameters:

Param Name Required/Optional Type Description
recordID Required String The record ID which you want to download after MP4 process

 

Example Requests:

https://api.mynaparrot.com/bigbluebutton/XXXX/api/downloadMP4?recordID=8b46e929c9e20d89f75df5d30bfdcc0b8b-1594097437792&checksum=b76be2cf5242bca922879ad2a976148f4e6c7b87

Example Response:

<response>
  <returncode>SUCCESS</returncode>
  <messageKey>gotURL</messageKey>
<mp4url>http%3A%2F%2Fr2.mynaparrot.es%2F6746627497a68bf020d3a13ac808058176f2ed56-1593532353702.mp4%3Fkey%3D8ESMSW66NAYbpd9S4RFmwg%26expires%3D1595219472</mp4url> </response>

 

Note: If the recording's length too long like more than 30 minutes, you may receive file in webm format but that file will play from any devices or players without any problem. Later you can convert it to MP4, if you really require but most of the time don't require. We are doing so to save time & deliver you the file soon.