Report a preview clip that has been played.Acceptable usage for this endpoint is 5 POST requests per second, and with batches of 500 logs per request. If you are likely to exceed this usage limit, MassiveMusic supports bulk batch submission of logs via an S3 bucket. This solution can be discussed this with your Client Success representative.
\ Example request
POST https://api.7digital.com/1.2/user/preview/log?country=EE&oauth_consumer_key=YOUR_KEY_HERE&oauth_token=...A country parameter is required in the query string. This is for OAuth authorisation, and must be a country your API key has access to. The country property in the POST body is the location in which the user played the clip.
Multiple plays can be batched into a single POST to this endpoint, up to a limit of 500 logs. The body must be sent as JSON format. Previews that are requested as part of pre-fetching functionality, but never played on the device, should still be logged with a zero second play time.
{
"logs": [
{
"userId": "141732543",
"country": "EE",
"trackId": 673059,
"dateTimePlayed": "2014-03-13T11:39:28.8981203Z",
"totalTimePlayed": 12,
"userAgent": "Device version 3, App version 6",
"playMode":"online",
"playType":"view"
}
]
}Example Response
{}{
"error": {
"code": 1008,
"message": "One or more logs contain an error",
"errors": [
{
"code": 1002,
"message": "'Date Time Played' cannot be too much in the past.",
"index": 4
}
]
}
}An HTTP 200 response means all logs were submitted successfully.
An HTTP non-200 response means we have not saved any logs. Errors should be fixed, and the whole batch resubmitted.
Specific Error Codes
- 1008 - One or more logs are invalid. Refer to the index field to know which logs failed and why.