Criar produto
POST
{{base_url}}/api/products
Autenticação
Bearer pela sua API Key real (vk_live_* produção, vk_test_* sandbox). Crie a chave em https://app.dotfy.com.br/dashboard/chaves-api. Sem o header → 401. Com chave inválida/revogada → 401. Com chave sem o escopo necessário → 403 insufficient_scope.products:write.| Campo | Tipo | Obrigatório | Regras |
|---|---|---|---|
title | string | sim | 3–100 chars. |
price | number | sim | Em REAIS, > 0, ≤ 100000. |
slug | string | sim | 3–50 chars, regex ^[a-z0-9-]+$. URL final: /checkout/{slug}. |
description | string | não | Máx 2000 chars. |
imageUrl | string | não | URL HTTPS válida. |
contentUrl | string | não | URL para entrega pós-pagamento. |
isActive | boolean | não | Default true. |
checkoutTheme | enum | não | LIGHT |
requireCustomerData | boolean | não | Default true (exige nome+email+CPF). |
sellerName | string | não | Override do nome no checkout. |
Requisição
Parâmetros Header
Parâmetros Bodyapplication/json
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff '{{base_url}}/api/products' \
--header 'Authorization: Bearer {{api_key}}' \
--header 'Content-Type: application/json' \
--data '{
"title": "Curso de Marketing Digital",
"description": "Acesso vitalício, 40 horas de conteúdo.",
"price": 297.00,
"slug": "curso-marketing-digital",
"isActive": true,
"checkoutTheme": "DARK",
"requireCustomerData": true,
"contentUrl": "https://seu-dominio.com/area-do-aluno"
}'Response Response Example
{}Modificado em 2026-05-07 16:12:35