COVERITLIVE API - COMMENT/PUBLISH (V. 2.0)

The Request

This method allows a comment that has been submitted to an event to be published. Comments from any source can be published, including regular comments submitted through the viewer window, comments submitted through the API and by email. Comments ids are returned by the comment/list and comment/create API methods.

URL:
https://api.coveritlive.com/remote/2/comment/publish
Response Formats:
JSON
HTTP Method(s):
POST
API Rate Limited:
false
In addition to the parameters listed in the Request Parameters section, the comment/publish method also includes the following parameters:

Parameter Description Required
event_code The event code for the event in which the comment exists. Each CiL event that is created is assigned a unique event code that identifies it in the database - The event owner can find this value after creating a new event, by selecting the "altcast_code" which is found in their Viewer Window embed code (e.g. the event code is "46e6cd22b5" in "altcast_code=46e6cd22b5"). This value is also returned by the event/list API method. yes
comment_id The id of the comment to be published. yes

The Response

There is no extra data returned from an comment/publish request, so the response has the same fields as a general response.

Example response to a successful comment/publish request:


{
	"result": "success",
	"message": "true",
	"type": "comment",
	"action": "publish",
	"version": 2
}

comment/publish Error Responses

A variety of error responses (in addition to the common error responses) to comment/publish requests, and instructions on how to rectify them:

result response message response solution
missing_comment_id_param Required parameter empty: comment_id Ensure the comment_id request parameter is present when making a comment/publish request.
comment_already_published The comment specified by comment_id has already been published. Comments can only be published once. The comment moderation status must be unpublished in order for the comment to be published (refer to the comment/list API method).