Atualizar cadeia de recompensas

Atualizar cadeia de recompensasServer-sideAdmin

put/v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}

Atualiza a cadeia de recompensas específica.

SecuritybasicAuth

Request

path Parameters

project_id required	integer ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto. Example: 44056
reward_chain_id required	integer ID da cadeia de recompensas. Example: 101

Request Body schema: application/json

One of:

Uma cadeia de recompensas.

required

(two-letter (object or null)) or (five-letter (object or null))

Objeto com traduções para o nome do item. Aceita valores em um dos dois formatos: códigos de idioma minúsculos de duas letras (por exemplo, en) ou códigos de idioma de cinco caracteres (por exemplo, en-US). Embora ambos os formatos sejam aceitos, as respostas retornam códigos de idioma minúsculos de duas letras. Quando ambas as opções para o mesmo idioma são fornecidas (por exemplo, en e en-US), o último valor fornecido é armazenado. Você pode encontrar a lista completa de idiomas suportados na documentação.

One of:

Códigos de idioma minúsculos de duas letras.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chinês (Simplificado)
cs	string or null Tcheco
de	string or null Alemão
en	string or null Inglês
es	string or null Espanhol (Espanha)
fr	string or null Francês
he	string or null Hebraico
id	string or null Indonésio
it	string or null Italiano
ja	string or null Japonês
km	string or null Khmer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmanês
ne	string or null Nepalês
ph	string or null Filipino
pl	string or null Polonês
pt	string or null Português
ro	string or null Romeno
ru	string or null Russo
th	string or null Tailandês
tr	string or null Turco
tw	string or null Chinês (Tradicional)
vi	string or null Vietnamita

required

Array of objects

Períodos de validade da cadeia de recompensas. Se múltiplos períodos forem especificados, tanto date_from quanto date_until são necessários.

Array

date_from required	string <date-time> Data de início da cadeia de recompensas especificada.
date_until	string or null <date-time> Data de término da cadeia de recompensas especificada. Pode ser `null` apenas se um único período de validade for especificado.

required

Array of objects

Array

required

(two-letter (object or null)) or (five-letter (object or null))

One of:

Códigos de idioma minúsculos de duas letras.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chinês (Simplificado)
cs	string or null Tcheco
de	string or null Alemão
en	string or null Inglês
es	string or null Espanhol (Espanha)
fr	string or null Francês
he	string or null Hebraico
id	string or null Indonésio
it	string or null Italiano
ja	string or null Japonês
km	string or null Khmer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmanês
ne	string or null Nepalês
ph	string or null Filipino
pl	string or null Polonês
pt	string or null Português
ro	string or null Romeno
ru	string or null Russo
th	string or null Tailandês
tr	string or null Turco
tw	string or null Chinês (Tradicional)
vi	string or null Vietnamita

required

object

amount

required

integer

Preço da etapa em pontos de valor.

required

Array of objects

Array

sku

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$

ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, pontos, traços e sublinhados.

quantity

required

integer

Quantidade do item.

Array of tipo = string (object) or tipo = number (object) or tipo = data (object) [ 1 .. 100 ] items

Condições para validação de atributos do usuário. Determine a disponibilidade da recompensa para as etapas da cadeia de recompensas com base em se os atributos do usuário correspondem a todas as condições especificadas.

Array ([ 1 .. 100 ] items)

One of:

attribute

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

Código de atributo do usuário.

operator

required

string

Tipo de operação realizada por condição. Para o tipo de atributo string.

Enum:	Description
eq	Iguais
ne	Diferentes

value

required

string <= 255 characters

Valor da condição com o qual o valor do atributo do usuário será comparado. O tipo depende do tipo de atributo.

type

required

string

Tipo de atributo de usuário.

Value: "string"

can_be_missing

boolean

Indica que a condição é atendida mesmo se o atributo estiver ausente dos atributos do usuário. Passe true para mostrar o item aos usuários que não têm esse atributo. Os usuários que têm o atributo, mas o valor não corresponder ao especificado na condição, não verão o item. false — os usuários que têm o atributo, mas o valor não corresponder ao especificado na condição, ou o atributo estiver ausente, não verão o item.

step_id

required

integer or null

ID de etapa exclusivo.

image_url

string or null

URL da imagem.

is_enabled

required

boolean

Array of tipo = string (object) or tipo = number (object) or tipo = data (object) [ 1 .. 100 ] items

Condições para validação de atributos do usuário. Determine a disponibilidade da cadeia com base em se os atributos do usuário correspondem a todas as condições especificadas.

Array ([ 1 .. 100 ] items)

One of:

attribute

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

Código de atributo do usuário.

operator

required

string

Tipo de operação realizada por condição. Para o tipo de atributo string.

Enum:	Description
eq	Iguais
ne	Diferentes

value

required

string <= 255 characters

Valor da condição com o qual o valor do atributo do usuário será comparado. O tipo depende do tipo de atributo.

type

required

string

Tipo de atributo de usuário.

Value: "string"

can_be_missing

boolean

(two-letter (object or null)) or (five-letter (object or null))

Objeto com traduções para a descrição do item. Aceita valores em um dos dois formatos: códigos de idioma minúsculos de duas letras (por exemplo, en) ou códigos de localidade de cinco caracteres (por exemplo, en-US). Embora ambos os formatos sejam aceitos, as respostas retornam códigos de idioma minúsculos de duas letras. Quando ambas as opções para o mesmo idioma são fornecidas (por exemplo, en e en-US), o último valor fornecido é armazenado. Você pode encontrar a lista completa de idiomas suportados na documentação.

One of:

Códigos de idioma minúsculos de duas letras.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chinês (Simplificado)
cs	string or null Tcheco
de	string or null Alemão
en	string or null Inglês
es	string or null Espanhol (Espanha)
fr	string or null Francês
he	string or null Hebraico
id	string or null Indonésio
it	string or null Italiano
ja	string or null Japonês
km	string or null Khmer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmanês
ne	string or null Nepalês
ph	string or null Filipino
pl	string or null Polonês
pt	string or null Português
ro	string or null Romeno
ru	string or null Russo
th	string or null Tailandês
tr	string or null Turco
tw	string or null Chinês (Tradicional)
vi	string or null Vietnamita

image_url

string or null

URL da imagem.

is_always_visible

boolean

Default: true

Se a cadeia deve ser visível para todos os usuários:

Se true, a cadeia é sempre exibida, independentemente do status de autenticação ou dos atributos do usuário.
Se false, a cadeia é exibida apenas se nenhuma cadeia personalizada for encontrada. Por exemplo, se o usuário não estiver autenticado, ou se seus atributos não corresponderem a nenhuma cadeia personalizada.

Aplica-se somente no contexto de cadeias personalizadas e é usado se a matriz attribute_conditions não for passada.

is_reset_after_end

boolean

Default: false

Se a cadeia de recompensas (pontos de valor e progresso de todos os usuários) deve ser redefinida ou não após sua data de término:

Se true, a cadeia de recompensas será redefinida após a data de término.
Se false, a cadeia de recompensas não será redefinida após a data de término.

Aviso

Não pode ser true se:

Houver um período de redefinição definido em recurrent_schedule.
O valor null for passado em periods.date_until.

(two-letter (object or null)) or (five-letter (object or null))

Objeto com traduções para a descrição longa do item. Aceita valores em um dos dois formatos: códigos de idioma minúsculos de duas letras (por exemplo, en) ou códigos de localidade de cinco caracteres (por exemplo, en-US). Embora ambos os formatos sejam aceitos, as respostas retornam códigos de idioma minúsculos de duas letras. Quando ambas as variantes para o mesmo idioma são fornecidas (por exemplo, en e en-US), o último valor fornecido é armazenado. Você pode encontrar a lista completa de idiomas suportados na documentação.

Any of:

Códigos de idioma minúsculos de duas letras.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chinês (Simplificado)
cs	string or null Tcheco
de	string or null Alemão
en	string or null Inglês
es	string or null Espanhol (Espanha)
fr	string or null Francês
he	string or null Hebraico
id	string or null Indonésio
it	string or null Italiano
ja	string or null Japonês
km	string or null Khmer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmanês
ne	string or null Nepalês
ph	string or null Filipino
pl	string or null Polonês
pt	string or null Português
ro	string or null Romeno
ru	string or null Russo
th	string or null Tailandês
tr	string or null Turco
tw	string or null Chinês (Tradicional)
vi	string or null Vietnamita

order

integer

Define a ordem do arranjo.

(interval_type = weekly (object or null)) or (interval_type = monthly (object or null)) or (interval_type = hourly (object or null))

Período de reinicialização recorrente da cadeia de recompensas.

One of:

Tipo semanal de atualização da cadeia de recompensas.

interval_type required	string Frequência da reinicialização recorrente da cadeia de recompensas. Value: "weekly"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... Hora em que a cadeia de recompensas é redefinida no fuso horário desejado (arredondamento para horas). Por exemplo, a hora definida para a redefinição da cadeia de recompensas é 01:00 para o fuso horário de Kuala Lumpur (GMT+8). Nesse caso, o valor do parâmetro `time` é '01:00:00+08:00'.
day_of_week required	integer [ 1 .. 7 ] Dia da semana em que a cadeia de recompensas é redefinida, onde '1' é segunda-feira e '7' é domingo.

Responses

204

Cadeia de recompensas atualizada com sucesso.

401

Autenticação básica não aprovada ou errada. Verifique se você usou a autenticação básica ou as credenciais corretas.

404

Cadeia de recompensa não encontrada.

422

Solicitação inválida.

Request samples

application/json

{"clan_type": "guild",
"description": {"en": "Clan reward chain description."
},
"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"is_enabled": true,
"long_description": {"en": "Clan reward chain long description."
},
"name": {"en": "Clan reward chain"
},
"order": 1,
"periods": [{"date_from": "2026-01-01T01:00:00+05:00",
"date_until": "2026-01-31T23:59:59+05:00"
},
{"date_from": "2026-02-01T01:00:00+05:00",
"date_until": "2026-02-28T23:59:59+05:00"
}
],
"popup_header": {"en": "How to unlock rewards"
},
"popup_image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"popup_instruction": {"en": "You should be a clan member to get clan rewards. You join a clan when a clan member invited you to the clan, and you accepted the invite. You can create your own clan."
},
"recurrent_schedule": {"day_of_week": 1,
"interval_type": "weekly",
"time": "01:00:00+08:00"
},
"steps": [{"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"name": {"en": "First step of the reward chain"
},
"price": {"amount": 10
},
"reward": [{"quantity": 5,
"sku": "com.xsolla.item_1"
},
{"quantity": 1,
"sku": "com.xsolla.item_2"
}
],
"step_id": 1
},
{"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"name": {"en": "Second step of the reward chain"
},
"price": {"amount": 15
},
"reward": [{"quantity": 5,
"sku": "com.xsolla.item_3"
},
{"quantity": 1,
"sku": "com.xsolla.item_4"
}
],
"step_id": 2
}
]
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}