Xsolla-logo
  • 문서화
  • 계정 생성

서버에서 사용자의 특성 업데이트Server-side

post/attributes/users/{user_id}/update

Updates and creates user’s attributes.

Notice
Rate limits for server-side methods are applied to this method.

SecurityAttributesServer
Request
path Parameters
user_id
required
string <uuid>

사용자 ID입니다. 게시자 계정 > 로그인 설정 > 사용자 > 사용자 이름/ID에서 확인할 수 있습니다.

Request Body schema: application/json
publisher_id
required
integer or null

요청의 대상이 되는 판매자 ID입니다. 요청 인증에 필요합니다.

Array of objects

지정된 게임의 특성 목록입니다. 존재하지 않는 특성을 추가하려면 이 특성을 key 매개변수로 설정합니다. 특성의 value를 업데이트하려면 해당 key 매개변수를 지정하고 새 value을 설정합니다. 한 번에 여러 특성을 변경할 수 있습니다.

Array
key
required
string <= 256 characters [A-Za-z0-9_]+

사용자의 특성을 식별하는 데 사용하는 특성의 이름입니다. 사용자별로 고유해야 합니다.

value
required
string <= 256 characters

사용자의 특성 값입니다.

attr_type
string
Default: "client"

Definition of user’s access level to service attributes:

  • client - A user-editable attribute. The values for this type of attributes are entered by a user or specified according to the in-game logics on the client side. For example, the name and character stats, game difficulty level, etc.
  • server - A read-only attribute. The values for this type of attributes are entered and edited on the server side of your application. We recommend that you use them for configuration of game character stats or user parameters that shouldn’t change regularly. For example, chance to get a bonus, game character key parameters, user categories, etc.
Enum: "client" "server"
data_type
string or null

특성의 데이터 유형

Enum: "string" "number" "integer" "boolean"
description
string or null

JSON 스키마의 특성에 대한 설명입니다.

format
string or null

JSON 스키마의 특성 형식입니다. date-time, date, time, duration, email, uri, uuid 또는 JSON 스키마 사양의 기타 형식일 수 있습니다.

permission
string or null

다른 사용자의 특성에 대한 사용자의 액세스 수준 정의입니다.

Enum: "public" "private"
publisher_project_id
integer

지정된 특성의 값을 업데이트하려는 게시자 계정의 프로젝트 ID입니다. 지정하지 않으면 메소드가 모든 게임의 일반 특성만 업데이트합니다.

removing_keys
Array of strings

삭제하려는 특성의 목록입니다. attributes 매개변수에서 동일한 특성을 지정하면 삭제되지 않습니다.

Responses
204

콘텐츠가 없음

400

잘못된 요청

403

금지됨

422

처리할 수 없는 엔터티

429

요청이 너무 많음

Request samples
application/json
{
  • "attributes": [
    ],
  • "publisher_id": 0,
  • "publisher_project_id": 0,
  • "removing_keys": [
    ]
}
Response samples
{
  • "error": {
    }
}