Get App Data

Gets user app data.

  • Keys can be up to 32 bytes in size. Values can be up to 1024 bytes in size.
  • Maximum number of key/value pairs are 30 entries per user in an application.

URI Fragment

/appdata/{-list|,|userId}/@self/@app

Parameter Name

Type

Description

userId

String or Number

Use "@me" for current user, or direct numeric user ID.

Supported Signing Methods

Client Only Signing, 3-legged Authorization Signing

Please refer here for the details of authentication flow and here for how to sign request to generate the Authorization header.

HTTP Method

GET

Request Header

The Authorization header is necessary for this call to succeed.

URL Query Parameters

Parameter Name

Type

Description

Required

fields

Array

Specify keys of appdata to get. If not specified, all key-value pairs are returned.

No

format

String

Only "json" is accepted.

No

Request Body

None.

Response Status Code

HTTP Status Code

HTTP Status Message

Meaning

200

OK

Data successfully acquired

400

Bad Request

Corrupt request data on the client side

401

Unauthorized

Authorization error

403

Forbidden

The resource exists, but access is not possible due to a reason other than an authorization error.

404

Not Found

The resource does not exist.

500

Internal Server Error

An error on the API server side

503

Service Unavailable

The API cannot be used temporarily

Response Body

  • Array of requested app data in JSON format. See actual response in examples.
  • Content-Type: application/json; charset=utf-8

Example Request & Response

Getting app data for current user.
Base String
HTTP Request
HTTP Response
Getting app data for multiple users.
Base String
HTTP Request
HTTP Response
 

PREVIOUS

Delete App Data

NEXT

Create App Data