Obter lista de promoções de bônus

A promoção adiciona itens bônus gratuitos à compra feita por um usuário. A promoção pode ser aplicada a cada compra dentro de um projeto ou a uma compra que inclua itens específicos.

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

query Parameters

limit	integer Limite da quantidade de elementos na página. Example: limit=50
offset	integer Número do elemento a partir do qual a lista é gerada (a quantidade começa a partir de 0). Example: offset=0

Responses

200

Lista de promoções bônus recebida 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.

Request samples

Response samples

application/json

{"active_promotions_count": 2,
"inactive_promotions_count": 0,
"promotions": [{"bonus": [{"quantity": 1,
"sku": "com.xsolla.elven_sword_1"
},
{"quantity": 2,
"sku": "com.xsolla.elven_shield_1"
},
{"quantity": 2,
"sku": "com.xsolla.elven_gloves_1"
}
],
"condition": [{"sku": "com.xsolla.elven_boots_1"
},
{"sku": "com.xsolla.elven_knife_1"
}
],
"date_end": "2020-04-25T18:16:00+05:00",
"date_start": "2020-04-15T18:16:00+05:00",
"id": 1,
"is_enabled": true,
"limits": {"per_item": null,
"per_user": null,
"recurrent_schedule": null
},
"name": {"de-DE": "Neujahrsbonus",
"en-US": "New Year Bonus"
}
},
{"bonus": [{"quantity": 100,
"sku": "com.xsolla.diamonds_1"
}
],
"condition": null,
"date_end": "2020-04-25T18:16:00+05:00",
"date_start": "2020-04-15T18:16:00+05:00",
"excluded_promotions": [1
],
"id": 2,
"is_enabled": true,
"limits": {"per_item": null,
"per_user": {"total": 10
},
"recurrent_schedule": {"per_user": {"day_of_month": null,
"day_of_week": null,
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"interval_type": "daily",
"reset_next_date": 1677553200,
"time": "11:00:00+08:00"
}
}
},
"name": {"de-DE": "Sommersaison Bonus",
"en-US": "Summer season bonus"
},
"price_conditions": [{"operator": "gt",
"value": "10.0000"
},
{"operator": "lt",
"value": "50.0000"
}
]
}
],
"total_promotions_count": 2
}