Xsolla-logo

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

post/attributes/users/{user_id}/update

사용자의 특성을 업데이트하고 생성합니다.

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"

서비스 특성에 대한 사용자의 액세스 수준 정의:

  • client - 사용자가 편집할 수 있는 특성입니다. 이 유형의 특성 값은 사용자가 입력하거나 클라이언트 측의 인게임 논리에 따라 지정됩니다. 예를 들어 이름 및 캐릭터 능력치, 게임 난이도 등입니다.
  • server - 읽기 전용 특성입니다. 이 유형의 특성 값은 애플리케이션의 서버 측에서 입력하고 편집합니다. 정기적으로 변경하지 않아야 하는 게임 캐릭터 능력치 또는 사용자 매개변수 구성에 사용하는 것이 좋습니다. 예를 들어 보너스를 받을 수 있는 기회, 게임 캐릭터 키 매개변수, 사용자 카테고리 등입니다.
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": {
    }
}