POST oauth/push notifications/devices
(Difference between revisions)
(Created page with "{{DISPLAYTITLE:POST push_notifications/devices}} == Description == Adds a new device to the Social Login App devices list. == Resource URL == POST https://api.socialidno...") |
|||
Line 28: | Line 28: | ||
== Authentication == | == Authentication == | ||
− | This API requires Login App Token authentication. See [[ | + | This API requires Login App Token authentication. See [[OAuth_APIs|OAuth]]. |
== Response == | == Response == | ||
Line 44: | Line 44: | ||
|- | |- | ||
! align="left" width="200px" | unauthorized (401) | ! align="left" width="200px" | unauthorized (401) | ||
− | | The authentication is wrong. See [[ | + | | The authentication is wrong. See [[OAuth_APIs|OAuth]]. |
|- | |- | ||
! align="left" width="200px" | unprocessable_entity (422) | ! align="left" width="200px" | unprocessable_entity (422) |
Revision as of 15:42, 12 August 2015
Contents |
Description
Adds a new device to the Social Login App devices list.
Resource URL
POST https://api.socialidnow.com/v2/marketing/push_notifications/devices
Parameters
JSON Parameters
device | required | a hash in the format field:value, with the necessary fields to create the device: |
---|---|---|
token | required | token to identify the device. |
platform | required | device platform: "ios" or "android". |
Authentication
This API requires Login App Token authentication. See OAuth.
Response
Response Status
created (201) | The device was created successfully. |
---|---|
ok (200) | The device had already been created. |
bad_request (400) | The parameter "device" wasn't informed or is not a hash. |
unauthorized (401) | The authentication is wrong. See OAuth. |
unprocessable_entity (422) | Validation error in the field "device". |
not_found (404) | No mobile application was found for the given Social Login App. |
internal_server_error (500) | An unknown error happened. |
Response Body
id | device identifier. |
---|
Examples
Request
Creates a new Android device for the Social Login App.
curl -iX POST 'https://api.socialidnow.com/v2/marketing/push_notifications/devices' \ -d '{ "device": { "platform":"android", "token":"US4Xy2tJyRg0Qe-DiuWXa1mLJAhYjSQ-fhLlmqrXq6iywBAhnqGb9-xlOneFF6lgyFbrs6wuJAdjpACt0D6374RFBpng7m8HuUgHWYZxfvlvBJL7f5nu0CSJHc5oYtOJI-raHizuWduPuvf05pfuAf6ETyqVfuZyyCOlUGhoJiS2TqH98c8NDym" } }' \ -H "Content-type:application/json" \ -H "Authentication: Bearer 0358172c0cd160dfa731c7a76284fe0c30580f3fc8d827831e9f8b1821d8124c"
Response
Response Headers
HTTP/1.1 201 Created Status: 201
Response Body
{ "id":"4e5274835193bd40844a2102e0a33b61b09a144a6e0ae4413cfd17e30be6dc4d" }