Pump.io supports a number of different interactions that can happen against media. Theser are commenting, liking/favoriting and (re-)sharing. Currently MediaGoblin supports just commenting although other interactions will come at a later date.

How to comment

Warning

Commenting on a comment currently is NOT supported.

Commenting is done by posting a comment activity to the users feed. The activity should look similiar to:

{
    "verb": "post",
    "object": {
        "objectType": "comment",
        "inReplyTo": <media>
    }
}

This is where <media> is the media object you have got with from the server.

Getting comments

The media object you get back should have a replies section. This should be an object which contains the number of replies and if there are any (i.e. number of replies > 0) then items will include an array of every item:

{
    "totalItems": 2,
    "items: [
        {
            "id": 1,
            "objectType": "comment",
            "content": "I'm a comment ^_^",
            "author": <author user object>
        },
        {
            "id": 4,
            "objectType": "comment",
            "content": "Another comment! Blimey!",
            "author": <author user object>
        }
    ],
    "url": "http://some.server/api/images/1/comments/"
}