Xsolla-logoXsolla Developers
ou
Conta de Distribuidor

Criar cadeia de recompensasServer-sideAdmin

post/v2/project/{project_id}/admin/reward_chain

Cria cadeias de recompensas.

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

date_start
required
string <date-time>

Data em que sua cadeia de recompensas começa.

required
Array of objects
Array
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
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 (objects) or Array of tipo = data (objects) or Array of tipo = number (objects)
One of:
[ 1 .. 100 ] items
Array ([ 1 .. 100 ] items)
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.

image_url
string or null

URL da imagem.

is_enabled
required
boolean
Array of tipo = string (objects) or Array of tipo = data (objects) or Array of tipo = number (objects)
One of:
[ 1 .. 100 ] items
Array ([ 1 .. 100 ] items)
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.

date_end
string or null <date-time>

Data em que sua promoção da cadeia de recompensas termina. Pode ser null. Se date_end for null, a cadeia de recompensas terá um tempo ilimitado.

(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 de recompensas 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 de recompensa adequada 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 de recompensa personalizadas e é usado se a matriz attribute_conditions não for passada.

(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 = semanal (object or null)) or (interval_type = mensal (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
201

A cadeia de recompensas foi criada 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.

422

Solicitação inválida.

Request samples
application/json
{}
Response samples
application/json
{
  • "reward_chain_id": 10
}