POST login/users/:user id/updates/facebook

(Difference between revisions)
Jump to: navigation, search
(JSON Parameters)
Line 24: Line 24:
 
| a hash with the necessary fields to post the update:
 
| a hash with the necessary fields to post the update:
 
|-
 
|-
! align="left" width="180px" style="padding-left: 20px" | message
+
! align="left" width="180px" style="padding-left: 20px" | message <sup>1</sup>
 
| width="200px" | optional
 
| width="200px" | optional
| update message.
+
| Update message.
 
|-
 
|-
! align="left" width="180px" style="padding-left: 20px" | link
+
! align="left" width="180px" style="padding-left: 20px" | link <sup>1</sup>
 
| width="200px" | optional
 
| width="200px" | optional
| update url.
+
| URL of the update attached link.
 
|-
 
|-
! align="left" width="180px" style="padding-left: 20px" | picture
+
! align="left" width="180px" style="padding-left: 20px" | place <sup>1</sup>
 
| width="200px" | optional
 
| width="200px" | optional
| update picture url.
+
| Facebook Page ID of the update location.
|-
+
! align="left" width="180px" style="padding-left: 20px" | name
+
| width="200px" | optional
+
| update link name.
+
|-
+
! align="left" width="180px" style="padding-left: 20px" | caption
+
| width="200px" | optional
+
| update link caption.
+
|-
+
! align="left" width="180px" style="padding-left: 20px" | description
+
| width="200px" | optional
+
| update link caption.
+
 
|}
 
|}
 +
 +
<sup>1</sup> At least one of these fields must be given.
  
 
== Authentication ==
 
== Authentication ==

Revision as of 15:06, 9 May 2017

Contents

Description

Posts a message to the user Facebook timeline.

Resource URL

  POST https://api.socialidnow.com/v1/marketing/login/users/:user_id/updates/facebook

Parameters

URL Parameters

user_id required user identifier.

JSON Parameters

update required a hash with the necessary fields to post the update:
message 1 optional Update message.
link 1 optional URL of the update attached link.
place 1 optional Facebook Page ID of the update location.

1 At least one of these fields must be given.

Authentication

This API requires Marketing Account authentication. See Authentication.

Examples

Request

 curl -iX POST 'https://api.socialidnow.com/v1/marketing/login/users/:user_id/updates/facebook' \
        -d '{"update": {"message": "Visit Social-ID NOW",
                        "link": "http://www.socialidnow.com",
                        "picture": "http://www.socialidnow.com/logo.png",
                        "name": "Social-ID NOW",
                        "caption": "Social Infrastructure Platform",
                        "description": "Social-ID NOW. Known your client better." }}' \
        -H 'Content-type: application/json' \
        --user <api_id>:<api_secret> 

Response

Response Headers

HTTP/1.1 201 Created
Status: 201
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox