Produtos do catalogo

/v1/products · o catálogo de produtos e serviços da conta.

O catálogo de produtos e serviços da conta, usado nas linhas de produto das negociações.

Método	Rota	Operação
GET	/v1/products, /v1/products/{id}	read
POST	/v1/products	insert
PUT	/v1/products/{id}	update

As listagens retornam todos os produtos, visíveis ou não. Use o filtro visible para restringir.

Filtros

Parâmetro	Comportamento
name	exato (sem diferenciar maiúsculas); name__contains para parcial
category	exato, sem diferenciar maiúsculas (nome da categoria)
visible	true / false

Ordenação: name (padrão).

curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/products?visible=true&category=Assinatura"

Payload

{
  "data": {
    "id": 15,
    "name": "Plano Mensal Premium",
    "description": "Acesso completo à plataforma com suporte prioritário.",
    "price": 199.9,
    "category": "Assinatura",
    "visible": true,
    "recurring": true,
    "created_at": "2025-11-20T08:00:00.000Z",
    "updated_at": "2026-02-14T10:30:00.000Z"
  }
}

Escrita

Campo	Tipo	Observações
name	string	obrigatório no POST; não anulável
description	string, anulável
price	número ≥ 0, anulável
category	string, anulável	nome da categoria, criada automaticamente se não existir; null remove
visible	booleano	padrão true
recurring	booleano	padrão false; define se o produto compõe o recurring_amount das negociações

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"name":"Plano Mensal Premium","price":199.90,"category":"Assinatura","recurring":true}' \
  "https://app-api.atendeserver.com.br/v1/products"

curl -X PUT -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"price":219.90,"visible":false}' "https://app-api.atendeserver.com.br/v1/products/15"