API Reference Livoo
Integre o ecossistema Livoo na sua plataforma. Acesse lives, produtos, pedidos e usuários em tempo real.
Base URL
https://api.livooliveshop.com/v1
Autenticação Obrigatório
Todos os endpoints requerem autenticação via Bearer Token. Obtenha sua chave de API no painel do vendedor em Configurações → API.
Header de autenticação
# Inclua em todas as requisições
Authorization: Bearer lv_live_sk_xxxxxxxxxxxxxxxx
Content-Type: application/json
Lives Stable
GET
/lives
Listar lives
Query Parameters
| Parâmetro | Tipo | Descrição |
|---|---|---|
| status | string | Filtrar por status: live, scheduled, ended |
| limit | number | Máximo de resultados (padrão: 20, máx: 100) |
| cursor | string | Cursor de paginação para próxima página |
Resposta 200
{
"data": [
{
"id": "live_8f2k3m",
"title": "Lançamento Coleção Verão",
"status": "live",
"viewers": 1432,
"started_at": "2026-04-15T01:00:00Z"
}
],
"cursor": "eyJpZCI6Im...",
"has_more": true
}
POST
/lives
Criar live
Body
| Campo | Tipo | Descrição |
|---|---|---|
| title * | string | Título da live (máx 100 chars) |
| scheduled_at | string | ISO 8601 — omitir para iniciar agora |
| products | string[] | IDs dos produtos a exibir na live |
Exemplo de requisição
{
"title": "Flash Sale — 48h",
"scheduled_at": "2026-04-20T20:00:00Z",
"products": ["prod_abc", "prod_xyz"]
}
Produtos Stable
GET
/products
Listar produtos
Query Parameters
| Parâmetro | Tipo | Descrição |
|---|---|---|
| q | string | Busca por nome ou SKU |
| in_stock | boolean | Filtrar somente produtos em estoque |
| limit | number | Máximo de resultados (padrão: 20) |
POST
/products
Criar produto
Body
| Campo | Tipo | Descrição |
|---|---|---|
| name * | string | Nome do produto |
| price * | number | Preço em centavos (BRL) |
| stock * | number | Quantidade em estoque |
| images | string[] | URLs das imagens do produto |
| sku | string | Código SKU interno |
DELETE
/products/:id
Remover produto
Remove permanentemente o produto. Produtos vinculados a pedidos em andamento não podem ser removidos — retorna 409 Conflict.
Pedidos Stable
GET
/orders
Listar pedidos
Query Parameters
| Parâmetro | Tipo | Descrição |
|---|---|---|
| status | string | pending, paid, shipped, delivered, cancelled |
| live_id | string | Filtrar pedidos de uma live específica |
| from | string | Data inicial ISO 8601 |
| to | string | Data final ISO 8601 |
Webhooks Beta
Receba notificações em tempo real quando eventos ocorrem na sua loja.
POST
/webhooks
Registrar webhook
Eventos disponíveis
| Evento | Descrição |
|---|---|
| order.created | Novo pedido realizado |
| order.paid | Pagamento confirmado |
| live.started | Live iniciada |
| live.ended | Live encerrada |
| product.sold_out | Produto esgotado |
Body
{
"url": "https://sua-plataforma.com/webhook",
"events": ["order.created", "order.paid"],
"secret": "seu_webhook_secret"
}
Códigos de Erro
| Código | Significado |
|---|---|
| 400 | Requisição inválida — verifique os parâmetros obrigatórios |
| 401 | Não autorizado — token ausente ou inválido |
| 403 | Sem permissão para este recurso |
| 404 | Recurso não encontrado |
| 409 | Conflito — recurso em estado incompatível |
| 429 | Rate limit atingido — máximo 100 req/min |
| 500 | Erro interno — contate contato@livooliveshop.com |