GET
https://api.myidvirtual.com
/
cupons
Listar Cupons
curl --request GET \
  --url https://api.myidvirtual.com/cupons
[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "code": "PROMO2024",
    "discount": 20,
    "discountType": "PERCENTAGE",
    "maxUses": 100,
    "currentUses": 45,
    "expiresAt": "2024-12-31T23:59:59.000Z",
    "active": true,
    "createdAt": "2024-01-15T10:30:00.000Z"
  },
  {
    "id": "223e4567-e89b-12d3-a456-426614174001",
    "code": "WELCOME10",
    "discount": 10,
    "discountType": "FIXED",
    "maxUses": 50,
    "currentUses": 12,
    "expiresAt": "2024-06-30T23:59:59.000Z",
    "active": true,
    "createdAt": "2024-01-10T14:20:00.000Z"
  }
]

​
Listar Cupons

Endpoint para listar cupons de desconto disponíveis.

​
Responses

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "code": "PROMO2024",
    "discount": 20,
    "discountType": "PERCENTAGE",
    "maxUses": 100,
    "currentUses": 45,
    "expiresAt": "2024-12-31T23:59:59.000Z",
    "active": true,
    "createdAt": "2024-01-15T10:30:00.000Z"
  },
  {
    "id": "223e4567-e89b-12d3-a456-426614174001",
    "code": "WELCOME10",
    "discount": 10,
    "discountType": "FIXED",
    "maxUses": 50,
    "currentUses": 12,
    "expiresAt": "2024-06-30T23:59:59.000Z",
    "active": true,
    "createdAt": "2024-01-10T14:20:00.000Z"
  }
]

​
Exemplo de Requisição

curl --location 'http://localhost:3333/cupons'
Sempre valide o cupom antes de aplicar o desconto, verificando data de expiração, número de usos e status ativo.