Categorias

Endpoint: /get/categories

Este endpoint devolve a lista de categorias internas.

Cada categoria inclui:

  • id_category — ID único da categoria
  • family — Nome da família
  • category — Nome da categoria
  • sub_category — Subcategoria
  • sub_category2 — Sub-subcategoria

Requer Autenticação

Todos os pedidos devem conter:

Authorization: Bearer {TOKEN}

Formatos suportados

  • XML (por omissão)
  • JSON
  • CSV

Exemplos de URL:

  • /api/get/categories
  • /api/get/categories/format/json
  • /api/get/categories/format/csv

Exemplo em PHP (leitura 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");

// Chamar endpoint de categorias internas
$endpoint = "$apiBase/get/categories/format/json";
$opts = [
    "http" => [
        "method" => "GET",
        "header" => "Authorization: Bearer $token"
    ]
];
$context = stream_context_create($opts);
$result = file_get_contents($endpoint, false, $context);

// Mostrar resultados
$categorias = json_decode($result, true);
foreach ($categorias as $cat) {
    echo "Família: {$cat['family']} | Categoria: {$cat['category']} | Sub: {$cat['sub_category']}\n";
}