LoadOnAirPromotions
The LoadOnAirPromotions API provides a list of all active On Air (Listen and Win) promotions that have been created or modified since the date and time specified in the fall between the sinceDate parameter
Parameters
- sinceDate-The earliest date of member registrations. Must be in the following format: yyyy-mm-dd
- siteID– Numeric identifier of the Site in the Frankly Media database
- partnerName – Unique identifier of the 3rd party calling the API. Provided by Frankly Media
- token – An encrypted string constructed using the passed-in parameters and the partner-specific “shared secret” provided by the Frankly Media. Unless requested differently by the partner, the MD5 hashing algorithm is used to produce the token. For the purpose of this call the following formula should be used: md5(memberID + shared secret). For the generic example refer to this article.
How to call
URL Format: https://api.enticent.com/Subscriptions.svc/LoadOnAirPromotions /{sinceDate}/{siteID}/{partnerName}/{token}. https://api.enticent.com/Subscriptions.svc/LoadOnAirPromotions /2009-01-01/718/partner/6D-E9-9A-B6-73-D8-10-79-BC-4F-EE-51-A4-84-15-D8
Return Value
The following XML structure is returned in the success scenario:
<onairs xmlns=”http://schemas.datacontract.org/2004/07/ListenerAPI.DataObjects” xmlns:i=”http://www.w3.org/2001/XMLSchema-instance”><onair><OnAirId>820131</OnAirId><Name>8:15am Double Your Paycheck Name Call</Name><Answer>barbara</Answer><Begins>2009-08-21T03:00:00</Begins><Ends>2009-08-22T15:00:00</Ends><Match>barb</Match><Points>barb</Points></onair></onairs>
Remarks
The method returns a limited number of records at a time (200). Call repeatedly until no records returned. For testing and debugging purposes, if you need to start again from record 1, call ResetLoadOnAirPromotions method with the same parameters.
