Estamos atualizando o site. É possível que algumas seções ainda não estejam totalmente operacionais ou apresentem erros.
Saber mais

Ferramentas

Aproveite os nossos dados de produto

A secção Ferramentas reúne as integrações para clientes. Comece com a Integração da base de produtos para obter produtos ativos, especificações, cores, acessórios, embalagem, logótipos e imagens do Media Manager — sem os reintroduzir manualmente.

  • Informação de produto sempre atualizada
  • Acesso automático a imagens (miniatura, média, completa)
  • Sem introdução manual de produtos do seu lado
  • Autenticação simples por chave API

Ferramentas disponíveis

Utilize estas ferramentas para integrar o nosso catálogo, pedir devoluções, descarregar ficheiros e enviar documentos com segurança.

Disponível

Integração da base de produtos

Ligue o seu site à nossa base de produtos para mostrar produtos e imagens em tempo real no seu próprio site.

Ler o manual do utilizador
Disponível

Descarregar base de produtos

Descarregue o catálogo completo em Excel no idioma atual do site.

Sign in to download Excel

Catalog Excel export is limited to administrators with product access.

Disponível

Pedido de RMA

Peça uma devolução, reparação ou substituição. Carregue fotos e acompanhe o caso pelo número RMA.

Iniciar pedido RMA
Disponível

Catálogo PDF anónimo

Descarregue um catálogo PDF profissional de todos os produtos, sem marca da empresa, no idioma atual.

Disponível

Carregador de ficheiros

Carregue com segurança encomendas, orçamentos e documentos técnicos.

Manual do utilizador

Siga estes passos para pedir acesso, criar credenciais, ligar o seu site e mostrar produtos do nosso catálogo.

Guia passo a passo

Um percurso claro desde o pedido de acesso até à manutenção contínua.

  1. Pedir acesso

    Contacte a nossa equipa ou use a sua conta de cliente para pedir acesso à integração da base de produtos. Depois de aprovado, poderá criar e gerir credenciais API conforme este guia.

    Mantenha os contactos da empresa atualizados para receber avisos sobre alterações da API.

  2. Criar uma chave API

    Gere uma chave API dedicada para o seu site ou aplicação.

    • Crie uma ligação com nome (por exemplo “Site associado”).
    • Copie a chave API de imediato — é mostrada apenas uma vez.
    • Guarde-a num gestor de segredos; nunca a publique num repositório público.
  3. Ligar o seu site

    Adicione as definições de ligação no CMS, middleware ou código:

    • URL base da API: https://www.ic-electronics.com/api/v1
    • Autenticação: envie X-Api-Key: YOUR_API_KEY ou Authorization: Bearer YOUR_API_KEY
    • Confirme uma chamada bem-sucedida a /api/v1/health e depois a /api/v1/products
  4. Importar ou mostrar produtos

    Use a API para listar produtos e carregar todos os detalhes:

    • Mostre nome, SKU, descrição, família e subfamília
    • Carregue especificações, cores, acessórios, embalagem e logótipos
    • Apresente imagens com object-fit: contain (nunca corte) usando URLs miniatura, média ou completa
    • Atualize periodicamente para manter apenas produtos ativos
  5. Manter a ligação

    Rode as credenciais quando a equipa mudar, monitore a utilização e revogue chaves que já não sejam necessárias. Se uma chave for exposta, desative-a de imediato e crie uma substituição.

Documentação da API

Use estes endpoints para obter produtos ativos e variantes de imagem do Media Manager. Apenas produtos publicados (ativos) são devolvidos.

URL da API https://www.ic-electronics.com/api/v1
Autenticação Chave API (X-Api-Key ou Bearer token)

Inclua a sua chave API secreta em cada pedido de produtos. O endpoint de saúde é público para testes de conectividade.

Endpoints

Método Caminho Descrição
GET /api/v1/health Verificação de estado (sem autenticação).
GET /api/v1/products Lista paginada de produtos ativos.
GET /api/v1/products/{id} Detalhe completo do produto, incluindo imagens e opções.

Campos disponíveis

Campo Tipo Descrição
id integer ID do produto
sku string SKU / referência do produto
name string Nome do produto
description string Descrição completa
short_description string Descrição curta
family string Nome da família
subfamily string Nome da subfamília
specifications array Pares etiqueta/valor de especificações
colors array Cores disponíveis
accessories array Acessórios relacionados
packing array Opções de embalagem
logos array Opções de logótipo / marcação
images array Objetos de imagem com thumbnail, medium, full e fit=contain
url string URL canónico do produto em ic-electronics.com

Pedido de exemplo

GET https://www.ic-electronics.com/api/v1/products?page=1&per_page=24
X-Api-Key: YOUR_API_KEY
Accept: application/json

Resposta de exemplo

{
  "ok": true,
  "page": 1,
  "per_page": 24,
  "total": 128,
  "items": [
    {
      "id": 42,
      "sku": "WGS-USB01",
      "name": "Custom USB flash drive",
      "family": "USB Memory",
      "subfamily": "Flash drives",
      "url": "https://www.ic-electronics.com/products/custom-usb-flash-drive",
      "image": {
        "thumbnail": "https://www.ic-electronics.com/media/thumbs/example.jpg",
        "medium": "https://www.ic-electronics.com/media/medium/example.jpg",
        "full": "https://www.ic-electronics.com/media/example.jpg",
        "fit": "contain"
      }
    }
  ]
}

Exemplo de código de integração

Exemplo mínimo em browser/Node que carrega produtos com uma chave API.

JavaScript
async function loadProducts(apiKey) {
  const res = await fetch('https://www.ic-electronics.com/api/v1/products?per_page=12', {
    headers: {
      'X-Api-Key': apiKey,
      'Accept': 'application/json'
    }
  });
  if (!res.ok) {
    throw new Error('API error ' + res.status);
  }
  const data = await res.json();
  return data.items; // each item includes image.thumbnail / medium / full
}

Substitua YOUR_API_KEY pelo segredo gerado para a sua ligação.

Perguntas frequentes

Respostas rápidas sobre a integração da base de produtos.

Que produtos estão incluídos?

Apenas produtos ativos são publicados através da API. Rascunhos ou produtos desativados nunca são devolvidos.

Como devem ser apresentadas as imagens?

Use as URLs miniatura, média ou completa e preserve sempre a proporção com object-fit: contain. Não corte nem distorça as imagens.

Posso criar várias chaves API?

Sim. Crie uma chave por site ou ambiente para poder revogar o acesso de forma independente.

Onde obtenho suporte?

Contacte a nossa equipa na página de Contacto se precisar de credenciais, limites mais altos ou ajuda na integração. Email info@ic-electronics.com ou telefone +34 942 086 630.

Pronto para ligar o seu catálogo?

Peça acesso ou fale com a nossa equipa sobre a integração da base de produtos.

Acessibilidade

Ajuste as definições de visualização para o seu conforto. As preferências são guardadas neste dispositivo.

Modos de cor
Tamanho do texto