Skip to main content

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:

FieldTypeComment
id_transactionintcustomer id transaction. Used to avoid double counting in the event of a retry.
assets[].id_pictureintIdentifier of picture. (from API of dataflow metadata).
assets[].countintimage 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
}
]
}'