cURL
curl "https://apiv3.usecorvex.com.br/api/v1/products?page=1&limit=20&status=PUBLISHED" \
-H "Authorization: Bearer cvx_live_YOUR_API_KEY" \
-H "X-Store-Id: 11111111-1111-4111-8111-111111111111"const res = await fetch(
'https://apiv3.usecorvex.com.br/api/v1/products?page=1&limit=20',
{ headers: {
Authorization: 'Bearer cvx_live_YOUR_API_KEY',
'X-Store-Id': '11111111-1111-4111-8111-111111111111',
} }
);
const body = await res.json();import requests
url = "https://apiv3.usecorvex.com.br/api/v1/products"
headers = {
"X-Store-Id": "<x-store-id>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"data": {
"products": [
{
"id": "22222222-2222-4222-8222-222222222222",
"storeId": "11111111-1111-4111-8111-111111111111",
"name": "Camiseta Preta",
"slug": "camiseta-preta",
"type": "PHYSICAL",
"status": "PUBLISHED",
"price": 99.9,
"discountedPrice": 79.9,
"costPrice": 40,
"currency": "BRL",
"media": {
"images": [
"https://cdn.example.com/camiseta-preta.png"
],
"videos": [],
"documents": []
},
"stock": 10,
"sku": "CAM-PRETA",
"barcode": null,
"description": "Camiseta de algodão.",
"shortDescription": null,
"logistics": {
"height": 2,
"width": 20,
"length": 30,
"weight": 0.2
},
"featured": false,
"createdAt": "2026-09-01T12:00:00.000Z",
"updatedAt": "2026-09-10T15:30:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
}
}
}{
"success": false,
"error": {
"message": "X-Store-Id deve ser um UUID válido",
"code": "VALIDATION_ERROR"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 400
}
}{
"success": false,
"error": {
"message": "Esta rota exige uma API Key. Use Authorization: Bearer cvx_live_...",
"code": "AUTH_API_KEY_REQUIRED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 401
}
}{
"success": false,
"error": {
"message": "Sua API Key não tem o escopo necessário para esta operação.",
"code": "AUTH_SCOPE_DENIED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 403
}
}{
"success": false,
"message": "Muitas requisições. Tente novamente em instantes.",
"error": "RATE_LIMITED",
"retryAfter": 12
}Produtos
Listar produtos
Lista produtos da loja com paginação e filtros. Sem status, omite produtos INACTIVE. A lista não inclui variantes — use a consulta por id.
GET
/
api
/
v1
/
products
cURL
curl "https://apiv3.usecorvex.com.br/api/v1/products?page=1&limit=20&status=PUBLISHED" \
-H "Authorization: Bearer cvx_live_YOUR_API_KEY" \
-H "X-Store-Id: 11111111-1111-4111-8111-111111111111"const res = await fetch(
'https://apiv3.usecorvex.com.br/api/v1/products?page=1&limit=20',
{ headers: {
Authorization: 'Bearer cvx_live_YOUR_API_KEY',
'X-Store-Id': '11111111-1111-4111-8111-111111111111',
} }
);
const body = await res.json();import requests
url = "https://apiv3.usecorvex.com.br/api/v1/products"
headers = {
"X-Store-Id": "<x-store-id>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"data": {
"products": [
{
"id": "22222222-2222-4222-8222-222222222222",
"storeId": "11111111-1111-4111-8111-111111111111",
"name": "Camiseta Preta",
"slug": "camiseta-preta",
"type": "PHYSICAL",
"status": "PUBLISHED",
"price": 99.9,
"discountedPrice": 79.9,
"costPrice": 40,
"currency": "BRL",
"media": {
"images": [
"https://cdn.example.com/camiseta-preta.png"
],
"videos": [],
"documents": []
},
"stock": 10,
"sku": "CAM-PRETA",
"barcode": null,
"description": "Camiseta de algodão.",
"shortDescription": null,
"logistics": {
"height": 2,
"width": 20,
"length": 30,
"weight": 0.2
},
"featured": false,
"createdAt": "2026-09-01T12:00:00.000Z",
"updatedAt": "2026-09-10T15:30:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
}
}
}{
"success": false,
"error": {
"message": "X-Store-Id deve ser um UUID válido",
"code": "VALIDATION_ERROR"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 400
}
}{
"success": false,
"error": {
"message": "Esta rota exige uma API Key. Use Authorization: Bearer cvx_live_...",
"code": "AUTH_API_KEY_REQUIRED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 401
}
}{
"success": false,
"error": {
"message": "Sua API Key não tem o escopo necessário para esta operação.",
"code": "AUTH_SCOPE_DENIED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 403
}
}{
"success": false,
"message": "Muitas requisições. Tente novamente em instantes.",
"error": "RATE_LIMITED",
"retryAfter": 12
}Authorizations
API Key no formato cvx_live_..., criada no painel Corvex. Não use JWT de sessão nem x-api-key.
Headers
UUID da loja. A chave precisa ter esta loja autorizada.
Query Parameters
Página (a partir de 1).
Required range:
x >= 1Itens por página. Máximo 100.
Required range:
1 <= x <= 100Filtro de status. Use all para incluir inativos.
Available options:
DRAFT, ACTIVE, PUBLISHED, INACTIVE, all Nome contém o texto (sem diferenciar maiúsculas).
Required string length:
1 - 100SKU do produto ou de uma variante.
Required string length:
1 - 100Preço mínimo.
Required range:
x >= 0Preço máximo.
Required range:
x >= 0Só produtos atualizados a partir deste instante (ISO 8601 com fuso).