Referência da API

Listar produtos

Retorna lista paginada de produtos, ordenados por `active DESC, createdAt DESC` (ativos primeiro). Cada item inclui `_count.offers` com a contagem de ofertas ativas vinculadas.

GET/v2/products

Autenticação

HTTP Basic Auth. Envie sua secret key no header:

Authorization: Basic {base64(secret:SUA_SECRET_KEY)}

Parâmetros

activeboolean (query, string)opcional

Filtra por status ativo. Sem o parâmetro, retorna todos.

Exemplo: true

searchstring (query)opcional

Busca case-insensitive em `name`, `description` e `externalId`.

Exemplo: marketing

pagenumber (query, 0-indexed)opcional

Página, começando em 0. Padrão: 0.

Exemplo: 0

limitnumber (query)opcional

Por página. Padrão: 20. Máximo: 100.

Exemplo: 20

includeDeletedboolean (query, string)opcional

Passe `true` para incluir produtos arquivados.

Exemplo: false

Respostas

200

Lista paginada com counter de ofertas ativas em cada item.

JSON

{
  "result": [
    {
      "id": "prd_111aaa-bbb-ccc",
      "externalId": "curso-mkt-2026",
      "name": "Curso de Marketing Digital",
      "description": "Curso completo com 50 horas de aulas",
      "imageUrl": "https://cdn.exemplo.com/curso-marketing.jpg",
      "active": true,
      "deletedAt": null,
      "createdAt": "2026-05-26T14:32:01.923Z",
      "updatedAt": "2026-05-26T14:32:01.923Z",
      "_count": { "offers": 3 }
    }
  ],
  "totalCount": 8
}

Exemplos

cURL

curl -X GET "https://api.pagnovo.com/v2/products?active=true" \
  -H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)"