Push API \ Publish a tweet on Twitter PHP SDK
Push API Resources
Resource/URI | POST |
---|---|
Facebook · Publish a post on a user's profile
/push/identities/<identity_token>/facebook/post.json
|
Publish User Post |
Facebook · Upload a picture on behalf of a user
/push/identities/<identity_token>/facebook/picture.json
|
Upload User Picture |
Facebook · Upload a video on behalf of a user
/push/identities/<identity_token>/facebook/video.json
|
Upload User Video |
Facebook · Publish a post to a group the user is member of
/push/identities/<identity_token>/facebook/group/post.json
|
Publish Group Post |
Facebook · Upload a picture to a group the user is member of
/push/identities/<identity_token>/facebook/group/picture.json
|
Upload Group Picture |
Facebook · Upload a video to a group the user is member of
/push/identities/<identity_token>/facebook/group/video.json
|
Upload Group Video |
Facebook · Publish a post on a page the user administers
/push/identities/<identity_token>/facebook/page/post.json
|
Publish Page Post |
Facebook · Upload a picture on behalf of a page that the user administers
/push/identities/<identity_token>/facebook/page/picture.json
|
Upload Page Picture |
Facebook · Upload a video on behalf of a page that the user administers
/push/identities/<identity_token>/facebook/page/video.json
|
Upload Page Video |
LinkedIn · Publish a post on a user's profile
/push/identities/<identity_token>/linkedin/post.json
|
Publish User Post |
LinkedIn · Publish a post on a company page the user administers
/push/identities/<identity_token>/linkedin/company/post.json
|
Publish Company Post |
Pinterest · Publish a pin on behalf of a user
/push/identities/<identity_token>/pinterest/board/<board_id>/pin.json
|
Publish Pin |
Pinterest · Publish a board on behalf of a user
/push/identities/<identity_token>/pinterest/board.json
|
Publish Board |
Twitter · Publish a tweet on a user's timeline
/push/identities/<identity_token>/twitter/post.json
|
Publish Tweet |
Twitter · Upload a picture on behalf of a user
/push/identities/<identity_token>/twitter/picture.json
|
Upload Picture |
Twitter · Upload a video on behalf of a user
/push/identities/<identity_token>/twitter/video.json
|
Upload Video |
YouTube · Publish a video on behalf of a user
/push/identities/<identity_token>/youtube/video.json
|
Upload Video |
YouTube · Add a video to a playlist
/push/identities/<identity_token>/youtube/playlist/<playlist_id>/video.json
|
Add Video to Playlist |
YouTube · Create a playlist on behalf of a user
/push/identities/<identity_token>/youtube/playlist.json
|
Create Playlist |
YouTube · Add a section to a user's channel
/push/identities/<identity_token>/youtube/channel/section.json
|
Add Channel Section |
Workflow
Request: the code to send to the API
Send an API request to this endpoint in order to publish a new Tweet on behalf of a Twitter user:
POST
/push/identities/<identity_token>/twitter/post.json
The <identity_token>
is obtained whenever one of your users connects using his Twitter account.
To be able to use this endpoint Twitter must be fully configured for your OneAll Site and the setting Permissions \ Access permission of your Twitter app must be set to Read and Write. You can use our Pull API to retrieve the existing tweets of a user.
POST
data to include in the request
{ "request": { "push": { "post": { "message": "#message#", "location": "#location#", "attachments": [ "#video/picture_id#" ] } } } }
Key | Description |
---|---|
* #message# |
The message to include in the Tweet. No more than 140 characters. Example: Hello World! |
#location# |
Place that can be attached to a Tweet. Example: Paris FRANCE |
attachments (list) | |
#video/picture_id# |
The Twitter identifier of a picture or video to attach to the Tweet. Up to four attachments are allowed. You can use our API to upload pictures and videos. Example: 910890718352281600 |
Result: the code returned by the API
Resultset Example
{ "response": { "request": { "date": "Thu, 21 Sep 2017 15:56:59 0200", "resource": "/push/identities/923843ec-1749-4cc1-988f-d6963f3b1baa/twitter/post.json", "status": { "flag": "success", "code": 200, "info": "Your request has been processed successfully" } }, "result": { "data": { "provider": "twitter", "object": "post", "post_id": "910891858989060096", "post_location": "https://twitter.com/OneAll/status/910891858989060091" } } } }