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