Skip to main content

​
📌 Endpoint

GET /stores/:storeId/coupons Lista os cupons da loja (não expirados). Os cupons sao retornados na ordem de position (ascendente).

​
🔐 Autenticação

  • Rota privada.
  • Requer header Authorization com sua API key e plano ativo.
{
	"Authorization": "SUA_API_KEY_AQUI"
}

​
🧾 Parâmetros de rota

ParâmetroTipoObrigatórioDescrição
storeIdstringSimID da loja

​
✅ Exemplo de requisição

curl -X GET "https://api.cabrapi.com.br/stores/STORE_ID/coupons" \
	-H "Authorization: SUA_API_KEY_AQUI"

​
🧩 Snippet (JavaScript - fetch, só trocar Authorization)

const API_BASE = "https://api.cabrapi.com.br";
const AUTHORIZATION = "SUA_API_KEY_AQUI";

const storesResponse = await fetch(`${API_BASE}/stores`, {
	headers: { Authorization: AUTHORIZATION }
});
const storesData = await storesResponse.json();
const storeId = storesData?.stores?.[0]?.id;

if (!storeId) throw new Error("Nenhuma loja encontrada para essa API key.");

const response = await fetch(`${API_BASE}/stores/${storeId}/coupons`, {
	headers: { Authorization: AUTHORIZATION }
});

const data = await response.json();
console.log({ status: response.status, data });

​
📦 Resposta de sucesso (200)

{
	"status": true,
	"code": "COUPONS_FETCHED",
	"coupons": [
		{
			"id": "COUPON_ID",
			"code": "bemvindo10",
			"position": 1,
			"discount": 10,
			"useLimit": -1,
			"expiredAt": null,
			"products": [
				{ "id": "PRODUCT_ID", "name": "Curso Premium" }
			],
			"categories": []
		}
	]
}

​
⚠️ Possíveis erros

  • 400 INVALID_DATA → parâmetros inválidos
  • 404 STORE_NOT_FOUND → loja não encontrada
  • 404 COUPONS_NOT_FOUND → nenhum cupom encontrado
  • 500 INTERNAL_SERVER_ERROR → erro interno