Picture display reporting
The number of displays of an image must be communicated to Music Story.
The counter is performed on the customer's side, and corresponds to the number of times an image is displayed, excluding eventual displays via list or thumbnail.
The declaration should be made once a day minimum.
The endpoint to use is " https://api.v2.music-story.com/report/picture/usage "
For testing purposes use this token: KUiKPN4ukFMZ8u0ppxrdh8SHoHjvo63HWtU3jr1n2es
The object to be passed in the body of the request is as follows:
Field | Type | Comment |
---|---|---|
id_transaction | int | customer id transaction. Used to avoid double counting in the event of a retry. |
assets[].id_picture | int | Identifier of picture. (from API of dataflow metadata). |
assets[].count | int | image display counter |
Example
curl -X 'POST' \
'https://api.v2.music-story.com/report/picture/usage' \
-H 'accept: */*' \
-H 'Authorization: Bearer XXXXX' \
-H 'Content-Type: application/json' \
-d '{
"id_transaction": 1713343643,
"assets": [
{
"id_picture": 4615,
"count": 124
},
{
"id_picture": 6976,
"count": 54
}
]
}'