Products – All Data

Endpoint: /get/products

Este endpoint devolve a listagem completa de produtos ativos, com informação detalhada de cada um.

Inclui dados como:

  • Nome do produto, PVP, preço de revenda (WholesalePrice)
  • Stock sugerido (best_quantity)
  • Descrições curta e longa
  • Referência e código EAN13
  • Dimensões (largura, altura, profundidade), peso
  • Classe energética, taxas (ecológica, REE, cópia)
  • IVA, estado (IsNew), data da última atualização
  • Marca e hierarquia de categorias (até sub-subcategoria)

Requer Autenticação

É necessário enviar o token JWT no cabeçalho da requisição:

Authorization: Bearer {TOKEN}

Formatos suportados

  • XML (formato por defeito)
  • JSON
  • CSV

URLs disponíveis:

  • /api/get/products
  • /api/get/products/format/json
  • /api/get/products/format/csv

Exemplo em PHP (chamada autenticada)

<?php

$apiBase = 'https://O.MEU.DNS/api';
$username = 'username@mail.pt';
$password = 'password';

// Obter token
$tokenUrl = "$apiBase/generate-token/username/$username/password/$password";
$response = file_get_contents($tokenUrl);
$data = json_decode($response, true);
$token = $data['token'] ?? die("Erro ao obter token");

// Pedir todos os produtos ativos
$endpoint = "$apiBase/get/products/format/json";
$opts = [
    "http" => [
        "method" => "GET",
        "header" => "Authorization: Bearer $token"
    ]
];
$context = stream_context_create($opts);
$result = file_get_contents($endpoint, false, $context);

// Mostrar resultados
$produtos = json_decode($result, true);
foreach ($produtos as $produto) {
    echo "Produto: {$produto['ProductName']} | PVP: {$produto['PVP']}€ | Marca: {$produto['Brand']}\n";
}