Closed Caption REST API Follow

Closed Captions over HTTP for Zoom Video Conferencing and Video Webinar

You can add Closed Captions to Zoom Video Conferencing and Video Webinar by using the format defined by Zoom to receive Closed Caption data.

URLs Provided by Zoom

Zoom expects Closed Caption data to arrive in a continuous sequence of POSTs. Every Meeting has a special URL. The URL of the POST will specify the destination of the data (the Meeting that the closed captions are associated with).

Example:

https://wmcapi.zoom.us/closedcaption?id=200610693&ns=GZHkEA==&expire=86400&spparams=id%2Cns%2Cexpire&signature=nYtXJqRKCW

The following parameter needs to be added to the URL of every POST:

name Description/Usage Example Fragment
seq Must be contained in all POSTs. Counter for all closed caption data posts. Counter must increase by one between posts of new caption data (it must not be increased for retries). &seq
lang Deutsch:de-DE;English:en-US;日本語:jp-JP;Español:es-ES;Français:fr-FR;简体中文:zh-CN &lang=en-US

Content Type

The content-type (mimetype) for all POSTs must be text/plain.

Content Data

All HTTP POSTs sent to the closed caption ingestion point must contain only closed caption data within the content body. Data must not be form encoded.

The body of the POST will contain the text for the closed caption data.  A line break may be indicated with '\n'(0x0D) in the closed caption text.

The content has the following format:

<TEXT>

Where 

<TEXT> UTF-8

Example:

1st HTTP post data: I'M SENDING 

2nd HTTP post data:SEVERAL CAPTIONS.\n

Response Codes

HTTP POSTs may return the following response codes:

Response Code
Meaning

405

Method not allowed. Not a POST.

400

Bad request. The meeting has not started.

403

Unauthorized. Could be due to missing &seq query parameter or missing &id, &signature, &expire or &ns.


Request Retries

Zoom recommends that you retry all codes. This includes the response codes 405, 400, 403 shown above, as well as additional codes such as 408 Request Timeout, 500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable, and 504 Gateway Timeout.

All HTTP POST requests should be performed with a timeout. If a request times out, it should be retried.

When performing retry requests, use randomized binary exponential backoff:

Wait a random period between [0..100] milliseconds and retry; if that fails, wait a random period between [0..200] milliseconds and retry; if that fails, wait a random period between [0..400] milliseconds and retry, and so on. You should retry until it makes more sense to move on to the next closed caption packet (after approximately 5 seconds).

HTTP POST returns Timestamp

A Timestamp value is present in the POST return body and corresponds to the time the POST was processed.  It may be used to correct the local clock on a client driving the server. Zoom strongly recommends using this value because local clocks are often poorly synchronized.

Example returned timestamp:

   2012-12-24T00:00:06.873

Example POST

POST /closedcaption?id=200610693&ns=GZHkEA==&expire=86400&sparams=id%2Cns%2Cexpire&signature=nYtXJqRKCW&seq=41&lang=en-US 
Host: wmcapi.zoom.us:80
Accept: */*
Content-Type: text/plain
Content-Length: 11
I'M SENDING
 
POST /closedcaption?id=200610693&ns=GZHkEA==&expire=86400&sparams=id%2Cns%2Cexpire&signature=nYtXJqRKCW&seq=42&lang=en-US 
Host: wmcapi.zoom.us:80
Accept: */*
Content-Type: text/plain
Content-Length: 18
SEVERAL CAPTIONS.\n
Was this article helpful?
Have more questions? Submit a request
Powered by Zendesk