To authenticate using the Sococo streaming API, you need to POST an api token and room code to /api/v1/login.

Variable Description
room This code represents the room you’d like to authenticate into. You can find this code by right clicking on any room in Sococo and clicking “Copy Room Link” or clicking on “Edit Room”

Example Copied Link:

Example Room Code from Link:
token This is the token generated by you from the portion of this guide entitled “Generating an API Token”

To form an authentication request, you will issue a POST to

The body of the request will need to be JSON encoded and contain the API Token and Room Code. The response will contain two cookie values “API-Cookie” and “API-Route.” These will need to be saved for establishing your streaming connection.

Example POST:

    "token": "[YOUR API TOKEN HERE]",
    "room": "[YOUR ROOM CODE HERE]"

Example Response:

HTTP/1.1 200 OK.
Server: Apache-Coyote/1.1.
Set-Cookie: API-Cookie="[value from server]"; Version=[value from server].
Set-Cookie: API-Route=[value from server]; Version=[value from server].
Content-Type: application/json.
Transfer-Encoding: chunked.
Date: Fri, 26 Sep 2014 00:05:57 GMT.