MP4/webm API

You can request to process your recording to MP4 using API. Here we 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 need to send process requests for your MP4 file. You can send 2 requests at a time. After that, wait until they finish processing before sending new request.

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 given your mp4ReadyURL value then our system will send in that URL a POST request with the recordId and mp4Link. Remember, the URL given as mp4Link will only be valid for 2 hours but you can generate a new link using downloadMP4 API call.

2) downloadMP4

When the file will be ready, you can send a request to download it. The link is only valid for two hours and can be generated again by 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 is longer than 30 minutes, then you may receive it in a webm format. This will play on any devices or players. You can later convert this to mp4 if you really need but most of the time don't need to. We are doing so to save time & deliver you the file faster.

MP4/webm files will be deleted automatically after 7 days, so you'll need to download the file prior to that time. It will not be possible for you to send your request a second time if the MP4/webm file has been deleted after 7 days.

We use cookies

We use cookies on our website. Some of them are essential for the operation of the site, while others help us to improve this site and the user experience (tracking cookies).