Push API \ Upload a picture to 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 upload a picture to the Twitter account of a user:
POST
/push/identities/<identity_token>/twitter/picture.json
The <identity_token> is obtained whenever one of your users connects using his Twitter account.
Successfully uploaded pictures are identified by a picture_id that can be used to attach the picture to a Tweet.
Pictures that are not attached to a Tweet will be removed from Twitter after 24 hours.
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.
POST data to include in the request
{
"request":{
"push":{
"picture":{
"description": "#description#",
"url": "#url#"
}
}
}
}
| Key | Description |
|---|---|
| #description# |
A description of the uploaded picture. Example: OneAll Logo |
| * #url# |
The fully qualified URL of the picture to upload. The picture may not be larger than 5MB and must have one of the following formats: jpeg, bmp, png, gif, tiff. Example: http://assets.oneallcdn.com/img/oneall/logo_sni_retina.png |
Result: the code returned by the API
Resultset Example
{
"response":{
"request":{
"date": "Thu, 21 Sep 2017 16:25:31 0200",
"resource": "/push/identities/923843ec-1749-4cc1-988f-d6963f3b1baa/twitter/picture.json",
"status":{
"flag": "success",
"code": 200,
"info": "Your request has been processed successfully"
}
},
"result":{
"data":{
"provider": "twitter",
"object": "picture",
"picture_id": "910890718352281600",
"expires_in": "86400"
}
}
}
}