Replies to items in an event can be created using this method. Any item that is within the event stream (such as Writer comments, reader comments, image posts, Tweets, etc.) can be replied to any number of times. The reply id is returned by this method if the reply is successfully created, allowing for further interactions through the API.
In addition to the parameters listed in the Request Parameters section, the reply/create method also includes the following parameters:
The event code for the event which the reply will be added to. 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.
The id of the event item to which the reply will be attached. Event item ids can be retrieved using the event/data API method
This is the textual comment of the reply. May include HTML markup. May not be > 5000 characters in length.
If provided AND the target event has Display Names enabled, the parameter provided here will be used for that display name.
If provided AND the target event has Writer Avatars enabled, the URI of an image that will be used as the avatar for the reply being created. Images are displayed at 48x48 pixels. If image provided does not match these dimensions it will be auto-resized in the Viewer Window.
By default, API provided replies will be styled to appear exactly like a regular reply. To customize the content design please include HTML styling and/or images.
After setting up your custom application we strongly recommend testing the API provided content in a Test event to ensure your content and all styling appears as intended.
If including images in your content, it is recommended that you explicitly set their CSS height property. This allows CoveritLive to properly calculate viewer window scrolling positions to help provide the optimal reading experience for your users.
The id of a successfully created reply is returned in the data field of a general response. This field will consist of a reply_id field, which contains the reply id.
Example response to a successful reply/create request:
CoveritLive is the leading live-event publishing platform. Since its release in 2007, CoveritLive has been used by thousands of writers to engage millions of readers around the world. It is actively used both by traditional bloggers, journalists, major brands and mainstream media.