curl -X POST "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/coupons/search?page=1&limit=20" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search": {
"value": "black",
"case_sensitive": false
},
"filters": [
{ "field": "discount_type", "operator": "=", "value": "percentage" },
{ "field": "status", "operator": "=", "value": true }
],
"sort": [
{ "field": "valid_until", "direction": "asc" }
]
}'
{
"data": [
{
"id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
"code": "BLACKFRIDAY25",
"name": "Black Friday 25%",
"discount_type": "percentage",
"discount_value": "25.000000",
"status": true,
"valid_from": "2026-11-25T00:00:00.000000Z",
"valid_until": "2026-11-30T23:59:59.000000Z",
"max_uses": 100,
"once_per_client": true,
"applies_to_all_branches": true,
"uses_count": 0,
"state": "scheduled",
"created_at": "2026-07-02T15:30:00.000000Z",
"updated_at": "2026-07-02T15:30:00.000000Z"
}
],
"meta": {
"current_page": 1,
"per_page": 15,
"total": 1
}
}
Promoções
Buscar cupons
Busque cupons por código ou nome, e filtre por estado, tipo ou filial.
POST
/
ecommerce
/
v2
/
apps
/
{app_id}
/
coupons
/
search
curl -X POST "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/coupons/search?page=1&limit=20" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search": {
"value": "black",
"case_sensitive": false
},
"filters": [
{ "field": "discount_type", "operator": "=", "value": "percentage" },
{ "field": "status", "operator": "=", "value": true }
],
"sort": [
{ "field": "valid_until", "direction": "asc" }
]
}'
{
"data": [
{
"id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
"code": "BLACKFRIDAY25",
"name": "Black Friday 25%",
"discount_type": "percentage",
"discount_value": "25.000000",
"status": true,
"valid_from": "2026-11-25T00:00:00.000000Z",
"valid_until": "2026-11-30T23:59:59.000000Z",
"max_uses": 100,
"once_per_client": true,
"applies_to_all_branches": true,
"uses_count": 0,
"state": "scheduled",
"created_at": "2026-07-02T15:30:00.000000Z",
"updated_at": "2026-07-02T15:30:00.000000Z"
}
],
"meta": {
"current_page": 1,
"per_page": 15,
"total": 1
}
}
string
obrigatório
O ID da sua loja no Jelou Shop.
integer
padrão:"1"
Número da página a retornar.
integer
padrão:"15"
Quantidade de resultados por página (máx. 100).
string
Filtra pelo estado derivado:
active, scheduled, expired, depleted ou inactive.object
object[]
Lista de filtros a aplicar.
object[]
curl -X POST "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/coupons/search?page=1&limit=20" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search": {
"value": "black",
"case_sensitive": false
},
"filters": [
{ "field": "discount_type", "operator": "=", "value": "percentage" },
{ "field": "status", "operator": "=", "value": true }
],
"sort": [
{ "field": "valid_until", "direction": "asc" }
]
}'
{
"data": [
{
"id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
"code": "BLACKFRIDAY25",
"name": "Black Friday 25%",
"discount_type": "percentage",
"discount_value": "25.000000",
"status": true,
"valid_from": "2026-11-25T00:00:00.000000Z",
"valid_until": "2026-11-30T23:59:59.000000Z",
"max_uses": 100,
"once_per_client": true,
"applies_to_all_branches": true,
"uses_count": 0,
"state": "scheduled",
"created_at": "2026-07-02T15:30:00.000000Z",
"updated_at": "2026-07-02T15:30:00.000000Z"
}
],
"meta": {
"current_page": 1,
"per_page": 15,
"total": 1
}
}
Campos buscáveis:
code, name
Campos filtráveis: status, discount_type, applies_to_all_branches, branches.id
Campos ordenáveis: created_at, valid_from, valid_until, code, statusEsta página foi útil?
⌘I