B2B PRISM Live Studio integrations overview

Prev Next

Available in Classic and VPC

To use B2B PRISM Live Studio, build the essential APIs (service APIs) for your service according to the specifications provided in this guide.

Reasons you must build service APIs

Service APIs serve as a gateway, facilitating the exchange of information between B2B PRISM Live Studio and your service for live streaming. Therefore, to ensure successful integration with your service, it is necessary to build and stably operate appropriate APIs in accordance with the specifications for your service.

Create new lives and view live stream data

B2B PRISM Live Studio must be able to create a new live broadcast and view data of the live broadcast to start streaming. Your service needs to forward the necessary streaming details such as streaming path (Example: RTMP URL) through service APIs to stream live on PRISM Live Studio.

Check live status

B2B PRISM Live Studio periodically checks the current status of the live. If the service you're using forcefully terminates or blocks a specific live broadcast's streaming, B2B PRISM Live Studio notifies the streamer of the live status and ends the live accordingly.

Collect live metrics

Streamers can collect metric data of lives in progress, such as views, likes, and chats, and forward the data to themselves through B2B PRISM Live Studio.

Other connection features

Your service can offer convenience to streamers in their broadcasts by providing additional features required for live through APIs in PRISM Live Studio. The provided additional features are as follows:

  • Transfer and view chats
  • Block and unblock chat users
  • Register and unregister chat admins

How to use service APIs

The service APIs for B2B PRISM Live Studio must be built in compliance with the basic standards and security guidelines.

Using REST APIs

Be cautious of the following when using REST APIs:

  • Service APIs follows the REST API standard.
  • Service APIs use GET, POST, PUT, and DELETE methods.
    • The OPTIONS and HEAD methods must never be exposed externally due to security concerns.
  • If there is no data for the requesting channel or live, 404 Not Found must be provided as the HTTP status, not 200 OK or Empty Body.
  • When requesting a list of resources such as channels, the list must be provided in descending order of edited time followed by descending order of created time.

Security and authentication

All service APIs must be provided through TLSv1.2 or higher SSL connections for security. The permissions of the service API must be provided through OAuth2.0 authentication.

  • B2B PRISM Live Studio obtains an access token with access rights to the service API using the OAuth2.0 authentication provided by your service and uses this access token to call the service API.
  • To connect your service with OAuth2.0 authentication, make sure to enter the following information when registering your service:
    • client-id: publicly known string that the OAuth2.0 server uses to identify the client application.
    • client-secret: password that the OAuth2.0 server uses to authenticate the client's identity along with client-id.
  • B2B PRISM Live Studio obtains the following information through OAuth2.0 authentication:
    • Access Token: string that the client uses to interact with the resource server on behalf of the user.
    • Refresh Token: the Refresh Token is used to obtain a new Access Token after the expiration of the current Access Token.
Note

For more information about OAuth2.0 integrations, see OAuth2.0 basic concepts and integrations.

Essential build and selective build APIs

The service APIs you need to build for your service are divided into the essential build APIs that must be built to utilize the features of B2B PRISM Live Studio and the selective build APIs to use additional features.

Note

For more information about building B2B PRISM Live Studio service APIs, see the API guide.

Essential build API

See the following details of the essential build APIs:

Category Sub-category Description Specifications
AUTH Login and authentication
  • Acquires and renews OAuth2.0 Access Token
  • Views user information
CHANNEL View channel
  • Views channel list
  • Views channel information
View live Views channel live list API specification for viewing channel live list
LIVE View live stream data View live status and statistics API specification for viewing live status and statistics
Create live Creates a new live API specification for creating live
Start and end live
  • Starts live streaming
  • Ends live streaming
  • API specification for live start
  • API specification for live end
    • Selective build API

      See the following details of the selective build APIs:

      Category Sub-category Description Dependency Spec
      LIVE_CHAT_LIST View chat
      • Views once every 3-5s while on-air
      • Provides only the chat history after a specific time through the Continuous key
      • Provides the maximum number of viewing features
      - API specification for viewing chat
      LIVE_CHAT_SEND Transfer chat Transfers specific chats LIVE_CHAT_LIST API specification for transferring chat
      LIVE_CHAT_DELETE Delete chat
      • Deletes specific chats
      • Provided only for the services with the chat delete feature
      • Requires unique IDs for chat
      LIVE_CHAT_LIST API specification for deleting chat
      USER_BAN Block and unblock chat users
      • Requires the unique ID of the user who wrote the chat
      • Current blocking status must be viewable
      LIVE_CHAT_LIST
      USER_BAN_TEMPORARY Block chat user temporarily
      • Requires the unique ID of the user who wrote the chat
      • Current blocking status must be viewable
    • LIVE_CHAT_LIST
    • USER_BAN
      • API specification for temporarily blocking chat user
        USER_MOD Grant and remove chat admin permissions
        • Requires the unique ID of the user who wrote the chat
        • Must be able to view the current admin
        LIVE_CHAT_LIST