Create App Data

 

Creates 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/{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

POST

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 create.

Yes

format

String

Only "json" is accepted.

No

Request Body

  • A JSON string with user definable key-value pairs. Please refer to the sample below for the actual JSON string.
  • Content-Type: application/json; charset=utf-8

Response Status Code

HTTP Status Code

HTTP Status Message

Meaning

201

Created

Data successfully created.

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

None.

Example Request & Response

Base String
HTTP Request
HTTP Response

PREVIOUS

Get App Data

NEXT

Update App Data