Social Sharing API \ Read the details of a published message

Workflow

1. Request: the code to send to the API

Send a GET request to the resource /sharing/messages/<sharing_message_token>.<format> to obtain the details of a previously published message.

2. Result: the code returned by the API

The API will return the publish message including the list of publications. A publication gives you information on which social network and on behalf of which user the message has been shared. If you have enabled tracking, the list of tracked urls is included.

	{
  "response": {
    "request": {
      "date": "Tue, 20 Dec 2011 19:20:30 +0100",
      "resource": "/sharing/messages/328ef915-da13-4b58-83f6-6a35af3b08c0.json",
      "status": {
        "flag": "success",
        "code":200,
        "info": "Your request has been processed successfully"
      }
    },
    "result": {
      "data": {
        "sharing_message": {
          "sharing_message_token": "328ef915-da13-4b58-83f6-6a35af3b08c0",
          "date_creation": "Tue, 20 Dec 2011 17:26:59 +0100",
          "parts": {
            "text": {
              "body": "oneall simplifies the integration of social networks for Web 2.0 and SaaS companies"
            },
            "picture": {
              "url": "http://oneallcdn.com/img/heading/slides/provider_grid.png"
            },
            "link": {
              "url": "http://www.oneall.com/",
              "name": "oneall.com",
              "caption": "Social Media Integration",
              "description": "Easily integrate social services like Facebook, Twitter, LinkedIn and Foursquare with your already-existing website."
            },
            "flags": {
              "enable_tracking": "1"
            }
          },
          "publications": [
            {
              "provider": "facebook",
              "user_token": "c1d82726-e81d-4e89-82af-fed19df8f64e",
              "identity_token": "32eb78f4-f82e-4833-8a7b-fa0348c6ff5d",
              "tracked_shorturls": [
                {
                  "shorturl": {
                    "shorturl_token": "8WEtk",
                    "original_url": "http://www.oneall.com/",
                    "short_url": "http://oal.lu/8WEtk",
                    "date_creation": "Tue, 20 Dec 2011 17:26:59 +0100",
                    "date_last_referral": "Tue, 20 Dec 2011 18:53:58 +0100",
                    "num_referrals": "1"
                  }
                }
              ]
            },
            {
              "provider": "facebook",
              "user_token": "c1d82726-e81d-4e89-82af-fed19df8f64e",
              "identity_token": "32eb78f4-f82e-4833-8a7b-fa0348c6ff5d",
              "tracked_shorturls": [
                {
                  "shorturl": {
                    "shorturl_token": "1va2k",
                    "original_url": "http://www.oneall.com/",
                    "short_url": "http://oal.lu/1va2k",
                    "date_creation": "Tue, 19 Dec 2011 17:26:59 +0100",
                    "date_last_referral": "Tue, 20 Dec 2011 18:53:58 +0100",
                    "num_referrals": "11"
                  }
                }
              ]
            }
          ]
        }
      }
    }
  }
}