Media Interactions
Last updated
Last updated
Media Interactions are Part of the Frontend API. They describe the Interaction between an existing Media Item and a User (who can be anonymous in certain Cases). Media Interactions need a valid Session (and most of them also a valid, loggedin User) to be processed.
POST https://api.nexx.cloud/v3.1/interactions/addcomment
| Name | Type | Description |
|---|---|---|
POST https://api.nexx.cloud/v3.1/interactions/addrate
POST https://api.nexx.cloud/v3.1/interactions/addreaction
POST https://api.nexx.cloud/v3.1/interactions/addlike
POST https://api.nexx.cloud/v3.1/interactions/addtofavourites
POST https://api.nexx.cloud/v3.1/interactions/addtowatchlist
POST https://api.nexx.cloud/v3.1/interactions/addtocart
POST https://api.nexx.cloud/v3.1/interactions/expressinterest
DELETE https://api.nexx.cloud/v3.1/interactions/removecomment
Please notice, that this Method needs the Comment ID as item, not as usual the Media ID as item (as every User may leave multiple Comments on a Media Item)
DELETE https://api.nexx.cloud/v3.1/interactions/removerate
DELETE https://api.nexx.cloud/v3.1/interactions/removelike
DELETE https://api.nexx.cloud/v3.1/interactions/removereaction
DELETE https://api.nexx.cloud/v3.1/interactions/removefromfavourites
DELETE https://api.nexx.cloud/v3.1/interactions/removefromwatchlist
DELETE https://api.nexx.cloud/v3.1/interactions/removefromcart
POST https://api.nexx.cloud/v3.1/interactions/addtowatched
This Methods fills the serverside Watch History of a User. The User must be loggedin for this Method. Besides non-Player Media Types, this Method should only be called by nexxPLAY directly.
POST https://api.nexx.cloud/v3.1/interactions/flagcomment
Please notice, that this Method needs the Comment ID as item, not as usual the Media ID as item.
POST https://api.nexx.cloud/v3.1/interactions/finishcart
POST https://api.nexx.cloud/v3.1/interactions/joinevent
POST https://api.nexx.cloud/v3.1/interactions/jointeam
DELETE https://api.nexx.cloud/v3.1/interactions/unjoinevent
DELETE https://api.nexx.cloud/v3.1/interactions/unjointeam
DELETE https://api.nexx.cloud/v3.1/interactions/removefromhistory
POST https://api.nexx.cloud/v3.1/interactions/registerclickedlink
POST https://api.nexx.cloud/v3.1/interactions/createclip
POST https://api.nexx.cloud/v3.1/interactions/preparedownload
POST https://api.nexx.cloud/v3.1/interactions/prepareofflinedownload
This Method needs a valid Session, that has been created in an App Context.
POST https://api.nexx.cloud/v3.1/interactions/finishofflinedownload
This Method needs a valid Session, that has been created in an App Context.
DELETE https://api.nexx.cloud/v3.1/interactions/removeofflinedownload
This Method needs a valid Session, that has been created in an App Context.
POST https://api.nexx.cloud/v3.1/interactions/sendform
All Form Elements, that are marked as mandatory must be sent via POST Parameters, as filled out by the User.
POST https://api.nexx.cloud/v3.1/interactions/sendpoll
As the Poll can be canceled anytime, the Result here is a Key/Value Object with the Question ID as Key and the User Input as value. JSON encode this Object and send it via the "result" Parameter.
POST https://api.nexx.cloud/v3.1/interactions/sendvoting
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
item
integer
the Media ID
streamtype
string
the Media Streamtype
text
string
the Comment itself
parent
number
if the Comment is a Reply to another Comment, the parent Comment ID
username
number
if the User is anonymous, the given Username
timestamp
number
if related to a nexxPLAY Delivery, the current Media Timestamp
currentitem
integer
the ID of the currently active Item - if the target Streamtype is a Container Streamtype.
item
string
the Media ID
streamtype
integer
the Media Streamtype
rating
integer
the Rating itself (1-5)
timestamp
number
if related to a nexxPLAY Delivery, the current Media Timestamp
currentitem
integer
the ID of the currently active Item - if the target Streamtype is a Container Streamtype.
item
string
the Media ID
streamtype
integer
the Media Streamtype
reaction
integer
the Reaction itself [haha, love, shock, sad, angry]
timestamp
number
if related to a nexxPLAY Delivery, the current Media Timestamp
currentitem
integer
the ID of the currently active Item - if the target Streamtype is a Container Streamtype.
item
integer
the Media ID
streamtype
string
the Media Streamtype
timestamp
number
if related to a nexxPLAY Delivery, the current Media Timestamp
currentitem
integer
the ID of the currently active Item - if the target Streamtype is a Container Streamtype.
item
integer
the Media ID
streamtype
string
the Media Streamtype
timestamp
number
if related to a nexxPLAY Delivery, the current Media Timestamp
currentitem
integer
the ID of the currently active Item - if the target Streamtype is a Container Streamtype.
item
integer
the Media ID
streamtype
string
the Media Streamtype
item
integer
the Media ID
streamtype
string
the Media Streamtype
item
integer
the Media ID
streamtype
string
the Media Streamtype
message
string
an optional Message, given by the User
timestamp
number
if related to a nexxPLAY Delivery, the current Media Timestamp
currentitem
integer
the ID of the currently active Item - if the target Streamtype is a Container Streamtype.
item
integer
the ID of the Comment
item
integer
the Media ID
streamtype
string
the Media Streamtype
item
integer
the Media ID
streamtype
string
the Media Streamtype
item
integer
the Media ID
streamtype
string
the Media Streamtype
item
integer
the Media ID
streamtype
string
the Media Streamtype
item
integer
the Media ID
streamtype
string
the Media Streamtype
item
integer
the Media ID
streamtype
string
the Media Streamtype
item
string
the Media ID
streamtype
string
the Media Streamtype
mediasession
string
the Media Session
payContext
string
the Reason for Playback on a Pay Element
parentContext
string
the parent Streamtype, if available
parentItem
number
the parent Media ID, if available
isPreview
boolean
set to 1, if the Playback was a Pay Preview
isBumper
boolean
set to 1, if Media is a Bumper
isMuted
boolean
set to 1, if Media started muted
isLocalPlayback
boolean
set to 1, if the Playback happend on a locally downloaded Item
playbackTime
number
the Timest
item
integer
the ID of the Comment
title
integer
an optional Name for the current Cart
item
integer
the ID of the Event to join
item
integer
the ID of the Team to join
item
integer
the ID of the Event to leave
item
integer
the ID of the Team to leave
item
integer
the Media ID
streamtype
string
the Media Streamtype
url
string
the clicked URL
item
string
the Media ID
streamtype
string
the Media Streamtype
from
number
the desired Start of the new Scene
to
number
the desired End of the new Scene
title
string
the desired Scene Title
item
integer
the Media ID
streamtype
string
the Media Streamtype
item
number
the Media ID
streamtype
string
the Media Streamtype
protection
integer
the desired Protection [drm, plain]
triggeredBy
string
the Way the Download was started [sdk, media]
item
string
the Media ID
streamtype
string
the Media Streamtype
operationid
number
the Operation ID from the prepareofflinedownload Method
bytes
integer
the received Size of the File
result
string
[ok, error]
item
integer
the Media ID
streamtype
string
the Media Streamtype
item
integer
the Form ID
currentHistory
string
the current Referrer URL
attachedFile
integer
the ID of an existing nexxOMNIA File
item
integer
the Poll ID
result
string
JSON encoded Set of current Result
item
integer
the Voting ID
voting
string
the selected Value