Vincular Usuário a Cupom
Descrição
Associa um usuário a um cupom de desconto no sistema. Se o vínculo já existir, o sistema retorna erro de validação.
Verbo
POST
URL Base
https://api.soargi.com
Endpoint
/coupons-users/add
Cabeçalhos
Parâmetro | Valor |
---|---|
Content-Type | application/json |
Authorization | Bearer Token |
Campos Esperados
Campo | Tipo | Obrigatório | Descrição |
---|---|---|---|
coupon_id | integer | Sim | ID do cupom a ser vinculado. |
user_id | integer | Sim | ID do usuário a ser vinculado ao cupom. |
Corpo da Requisição
{
"coupon_id": 1,
"user_id": 4
}
Sucesso - 201
{
"success": true,
"message": "User linked to coupon successfully."
}
Erro - 400 (Validação)
{
"status": 400,
"error": 400,
"messages": "coupon_id and user_id are required."
}
Erro - 400 (Vínculo existente)
{
"status": 400,
"error": 400,
"messages": "This user is already linked to the coupon."
}
Erro - 500 (Falha ao vincular usuário ao cupom)
{
"status": 500,
"error": 500,
"messages": {
"error": "Failed to link user to coupon."
}
}
Códigos de Resposta
- 201 - Usuário vinculado com sucesso
- 400 - Campos obrigatórios ausentes/Usuário já vinculado
- 500 - Erro interno no servidor