Skip to main content
GET
/
products
Listar Produtos
curl --request GET \
  --url https://api.example.com/products
{
  "200": {},
  "401": {},
  "500": {}
}

Visão Geral

Este endpoint retorna uma lista paginada de todos os produtos cadastrados na sua conta KlivoPay.

Endpoint

GET https://api.klivopay.com.br/api/public/v1/products

Parâmetros

api_token
string
required
Seu token de autenticação da API KlivoPay
page
integer
default:"1"
Número da página para paginação
per_page
integer
default:"20"
Quantidade de itens por página (máximo: 100)

Exemplo de Requisição

curl -X GET 'https://api.klivopay.com.br/api/public/v1/products?api_token=seu_token_aqui&page=1&per_page=20'

Resposta de Sucesso

200 OK
{
  "success": true,
  "data": [
    {
      "hash": "prod123abc",
      "title": "Curso de Marketing Digital",
      "cover": "https://cdn.klivopay.com.br/products/cover123.jpg",
      "product_type": "digital",
      "payment_type": 1,
      "amount": 29900,
      "category": {
        "id": 5,
        "name": "Educação"
      },
      "created_at": "2025-01-15T10:00:00Z"
    },
    {
      "hash": "prod456def",
      "title": "E-book Vendas Online",
      "cover": "https://cdn.klivopay.com.br/products/cover456.jpg",
      "product_type": "digital",
      "payment_type": 1,
      "amount": 4900,
      "category": {
        "id": 5,
        "name": "Educação"
      },
      "created_at": "2025-01-10T14:30:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 12,
    "total_pages": 1
  }
}

Códigos de Resposta

200
OK
Lista de produtos retornada com sucesso
401
Unauthorized
Token de API inválido ou ausente
500
Internal Server Error
Erro interno do servidor