Devices

Devices Documentation

Device [LIST]

Device [LIST]

Request

Endpoint

GET /api/v2/user/devices
Content-Type: application/vnd.api+json

Body

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": [
    {
      "id": "e18db7f1-9132-4485-a29c-5925bc330d22",
      "type": "user_devices",
      "attributes": {
        "created_at": "2021-11-23T14:38:01Z",
        "locale": "en",
        "platform": "GCM",
        "updated_at": "2021-11-23T14:38:01Z",
        "updated_in_db_at": "2021-11-23T14:38:01Z",
        "version": "0.0.1"
      },
      "relationships": {
        "user": {
          "data": {
            "id": "b5e13cac-943b-4367-b487-9af00eebbda7",
            "type": "users"
          }
        }
      }
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_count": 1,
      "total_pages": 1
    },
    "sort": null,
    "filter": {
    }
  }
}

Fields

data

Type [Device]

Description An array of Device Objects

Device [POST]

Device [POST]

Request

Endpoint

POST /api/v2/user/devices
Content-Type: application/vnd.api+json

Body

{
  "data": {
    "type": "user_devices",
    "attributes": {
      "locale": "en",
      "platform": "GCM",
      "token": "934da874-8d83-4712-9a54-28492be90937",
      "updated_in_db_at": "2021-11-23 14:38:01 UTC",
      "version": "0.0.1"
    }
  }
}

Parameters

Attributes

created_at

Type date

Description The timestamp of when this resource was created

Required No

locale

Type string

Description The locale set on the device (to localize push notifications sent to the device)

Required No

platform

Type string

Description The platform which the device is registered on (must be either APNS or GCM)

Required No

token

Type string

Description The token provided by the platform needed for the server to send notifications to the device

Required No

updated_at

Type date

Description The timestamp of when this resource was last updated

Required No

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Required No

version

Type string

Description The version of the client app installed on the device

Required No

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
201 Created

Body

{
  "data": {
    "id": "1970713f-dcbc-40ae-a237-eccd22f84c48",
    "type": "user_devices",
    "attributes": {
      "created_at": "2021-11-23T14:38:01Z",
      "locale": "en",
      "platform": "GCM",
      "updated_at": "2021-11-23T14:38:01Z",
      "updated_in_db_at": "2021-11-23T14:38:01Z",
      "version": "0.0.1"
    },
    "relationships": {
      "user": {
        "data": {
          "id": "62b15bc7-8420-4512-9959-fcc8096d78d4",
          "type": "users"
        }
      }
    }
  }
}

Fields

Attributes

created_at

Type date

Description The timestamp of when this resource was created

locale

Type string

Description The locale set on the device (to localize push notifications sent to the device)

platform

Type string

Description The platform which the device is registered on (must be either APNS or GCM)

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

version

Type string

Description The version of the client app installed on the device

Relationships

user.data

Type User

Description A user that this device is associated with

Device [GET]

Device [GET]

Request

Endpoint

GET /api/v2/user/devices/91a9c0e5-35ce-4f99-9c8a-4d9b97a4aabd
Content-Type: application/vnd.api+json

Body

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": {
    "id": "91a9c0e5-35ce-4f99-9c8a-4d9b97a4aabd",
    "type": "user_devices",
    "attributes": {
      "created_at": "2021-11-23T14:38:01Z",
      "locale": "en",
      "platform": "GCM",
      "updated_at": "2021-11-23T14:38:01Z",
      "updated_in_db_at": "2021-11-23T14:38:01Z",
      "version": "0.0.1"
    },
    "relationships": {
      "user": {
        "data": {
          "id": "f8becbad-d8e4-462f-a456-b710e2d46a54",
          "type": "users"
        }
      }
    }
  }
}

Fields

Attributes

created_at

Type date

Description The timestamp of when this resource was created

locale

Type string

Description The locale set on the device (to localize push notifications sent to the device)

platform

Type string

Description The platform which the device is registered on (must be either APNS or GCM)

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

version

Type string

Description The version of the client app installed on the device

Relationships

user.data

Type User

Description A user that this device is associated with

Device [DELETE]

Device [DELETE]

Request

Endpoint

DELETE /api/v2/user/devices/e52d232d-52a3-46aa-97ee-c3d393ad6c25
Content-Type: application/vnd.api+json

Body

Response

Headers

204 No Content

Body