This method allows the display of published pin items to be ordered. There must be at least 2 published pin items to order. Each call must reorder all of the currently published pin items (ie. single item reordering is not supported). The ordering is achieved by passing a json encoded array of the ids and positions of each pin item.
In addition to the parameters listed in the Request Parameters section, the pin/order method also includes the following parameters:
The event code for the event in which the pin items to be ordered exist. 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.
A json encoded array of the published pin item ids, and the positions in which to order them. All of the currently published pin items must be represented, and each position may only be used once. For example, for two published pin items:
A variety of error responses (in addition to the common error responses) to pin/order requests, and instructions on how to rectify them:
Required parameter empty: order_data
Ensure the order_data request parameter is present when making a pin/order request.
Not enough published pin items to order.
There must be at least 2 published pin items to order.
The order_data request parameter did not contain a valid value.
Ensure the order_data parameter contains 1 JSON object entry per published pin item. Each JSON object must have pin_id and position properties.
Not all available positions were represented in the order_data request parameter.
Each JSON object in the order_data parameter must contain a position property, and all available positions must be represented. For example, if there are two published pin items, the positions 1 and 2 must be present as the properties of two JSON objects. If there are three published pin items, the positions 1, 2 and 3 must be present as the properties of three JSON objects.
One or more of the pin_ids in the order_data request parameter were invalid.
Ensure that the pin_id properties of the objects in the order_data parameter are valid ids for currently published pin items.
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.