> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usealpa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Referência

> Documentação completa da API de Cupons

## Cupons

Crie e gerencie cupons de desconto para aplicar em pagamentos.

<Note>
  Para um guia completo sobre Cupons, consulte [Coupons Guide](/pages/guides/features/coupons).
</Note>

## Endpoints Disponíveis

### Endpoint Público

* **POST** `/api/coupons/validate` - [Validar cupom (público)](/pages/coupon/validate) - Não requer autenticação

### Endpoints Privados (API v1)

* **POST** `/api/v1/coupons` - [Criar um novo cupom](/pages/coupon/create)
* **GET** `/api/v1/coupons` - [Listar cupons](/pages/coupon/list)
* **GET** `/api/v1/coupons/{id}` - [Obter cupom específico](/pages/coupon/get)
* **PATCH** `/api/v1/coupons/{id}` - [Atualizar cupom](/pages/coupon/update)
* **DELETE** `/api/v1/coupons/{id}` - [Deletar cupom](/pages/coupon/delete)

### Endpoints Privados (Dashboard)

* **GET** `/api/coupons` - Listar cupons
* **POST** `/api/coupons` - Criar cupom
* **GET** `/api/coupons/{id}` - Obter cupom
* **PATCH** `/api/coupons/{id}` - Atualizar cupom
* **DELETE** `/api/coupons/{id}` - Deletar cupom

## Autenticação

### Endpoint Público

`/api/coupons/validate` não requer autenticação. Apenas rate limiting por IP.

### Endpoints API v1

Requerem autenticação via Bearer Token (API Key):

```
Authorization: Bearer SUA_API_KEY
```

## Base URL

```
https://alpa-sistema-api.onrender.com
```