cURL
curl -X POST "https://apiv3.usecorvex.com.br/api/v1/products" \
-H "Authorization: Bearer cvx_live_YOUR_API_KEY" \
-H "X-Store-Id: 11111111-1111-4111-8111-111111111111" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: erp-item-88341" \
-d '{"name":"Camiseta Preta","type":"PHYSICAL","price":99.9,"stock":{"quantity":10},"sku":"CAM-PRETA","logistics":{"height":2,"width":20,"length":30,"weight":0.2}}'const options = {
method: 'POST',
headers: {
'X-Store-Id': '<x-store-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Camiseta Preta',
type: 'PHYSICAL',
price: 99.9,
discountedPrice: 79.9,
media: {images: ['https://cdn.example.com/camiseta-preta.png']},
status: 'DRAFT',
stock: {quantity: 10},
sku: 'CAM-PRETA',
logistics: {height: 2, width: 20, length: 30, weight: 0.2}
})
};
fetch('https://apiv3.usecorvex.com.br/api/v1/products', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apiv3.usecorvex.com.br/api/v1/products"
payload = {
"name": "Camiseta Preta",
"type": "PHYSICAL",
"price": 99.9,
"discountedPrice": 79.9,
"media": { "images": ["https://cdn.example.com/camiseta-preta.png"] },
"status": "DRAFT",
"stock": { "quantity": 10 },
"sku": "CAM-PRETA",
"logistics": {
"height": 2,
"width": 20,
"length": 30,
"weight": 0.2
}
}
headers = {
"X-Store-Id": "<x-store-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"data": {
"product": {
"id": "22222222-2222-4222-8222-222222222222",
"storeId": "11111111-1111-4111-8111-111111111111",
"name": "Camiseta Preta",
"slug": "camiseta-preta",
"type": "PHYSICAL",
"status": "DRAFT",
"price": 99.9,
"discountedPrice": 79.9,
"costPrice": null,
"currency": "BRL",
"media": {
"images": [
"https://cdn.example.com/camiseta-preta.png"
],
"videos": [],
"documents": []
},
"stock": 10,
"sku": "CAM-PRETA",
"barcode": null,
"description": "Camiseta Preta",
"shortDescription": "Camiseta Preta",
"logistics": {
"height": 2,
"width": 20,
"length": 30,
"weight": 0.2
},
"featured": false,
"createdAt": "2026-09-24T14:00:00.000Z",
"updatedAt": "2026-09-24T14:00:00.000Z"
}
}
}{
"success": false,
"error": {
"message": "logistics é obrigatório para produtos PHYSICAL (height, width, length, weight)",
"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,
"error": {
"message": "Já existe um produto com este identificador nesta loja.",
"code": "DUPLICATE_ENTRY"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 409
}
}{
"success": false,
"message": "Muitas requisições. Tente novamente em instantes.",
"error": "RATE_LIMITED",
"retryAfter": 12
}Produtos
Criar produto
Cria um produto na loja. PHYSICAL exige logistics. Envie Idempotency-Key para retries sem duplicar.
POST
/
api
/
v1
/
products
cURL
curl -X POST "https://apiv3.usecorvex.com.br/api/v1/products" \
-H "Authorization: Bearer cvx_live_YOUR_API_KEY" \
-H "X-Store-Id: 11111111-1111-4111-8111-111111111111" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: erp-item-88341" \
-d '{"name":"Camiseta Preta","type":"PHYSICAL","price":99.9,"stock":{"quantity":10},"sku":"CAM-PRETA","logistics":{"height":2,"width":20,"length":30,"weight":0.2}}'const options = {
method: 'POST',
headers: {
'X-Store-Id': '<x-store-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Camiseta Preta',
type: 'PHYSICAL',
price: 99.9,
discountedPrice: 79.9,
media: {images: ['https://cdn.example.com/camiseta-preta.png']},
status: 'DRAFT',
stock: {quantity: 10},
sku: 'CAM-PRETA',
logistics: {height: 2, width: 20, length: 30, weight: 0.2}
})
};
fetch('https://apiv3.usecorvex.com.br/api/v1/products', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apiv3.usecorvex.com.br/api/v1/products"
payload = {
"name": "Camiseta Preta",
"type": "PHYSICAL",
"price": 99.9,
"discountedPrice": 79.9,
"media": { "images": ["https://cdn.example.com/camiseta-preta.png"] },
"status": "DRAFT",
"stock": { "quantity": 10 },
"sku": "CAM-PRETA",
"logistics": {
"height": 2,
"width": 20,
"length": 30,
"weight": 0.2
}
}
headers = {
"X-Store-Id": "<x-store-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"data": {
"product": {
"id": "22222222-2222-4222-8222-222222222222",
"storeId": "11111111-1111-4111-8111-111111111111",
"name": "Camiseta Preta",
"slug": "camiseta-preta",
"type": "PHYSICAL",
"status": "DRAFT",
"price": 99.9,
"discountedPrice": 79.9,
"costPrice": null,
"currency": "BRL",
"media": {
"images": [
"https://cdn.example.com/camiseta-preta.png"
],
"videos": [],
"documents": []
},
"stock": 10,
"sku": "CAM-PRETA",
"barcode": null,
"description": "Camiseta Preta",
"shortDescription": "Camiseta Preta",
"logistics": {
"height": 2,
"width": 20,
"length": 30,
"weight": 0.2
},
"featured": false,
"createdAt": "2026-09-24T14:00:00.000Z",
"updatedAt": "2026-09-24T14:00:00.000Z"
}
}
}{
"success": false,
"error": {
"message": "logistics é obrigatório para produtos PHYSICAL (height, width, length, weight)",
"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,
"error": {
"message": "Já existe um produto com este identificador nesta loja.",
"code": "DUPLICATE_ENTRY"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 409
}
}{
"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.
Chave de idempotência (1–128 caracteres). Replay em 24h devolve o mesmo produto.
Pattern:
^[A-Za-z0-9._-]{1,128}$Body
application/json
Required string length:
3 - 100Available options:
PHYSICAL, DIGITAL Required range:
0.01 <= x <= 999999.99Preço promocional. Sempre menor que price. Use null se não houver desconto.
Required range:
x >= 0Mídia do produto. A primeira URL de images vira a imagem principal.
Show child attributes
Show child attributes
Available options:
DRAFT, ACTIVE, PUBLISHED, INACTIVE Show child attributes
Show child attributes
Show child attributes
Show child attributes
Maximum string length:
100Maximum string length:
100Required range:
0 <= x <= 999999.99Show child attributes
Show child attributes