We are updating the website. Some sections may not be fully operational yet or may contain errors.
Learn more

Tools

Take advantage of our product data

Our Tools section is the home of customer-facing integrations. Start with Product Database Integration to retrieve active products, specifications, colours, accessories, packaging, logos and images from Media Manager — without re-entering them manually.

  • Always up-to-date product information
  • Automatic access to product images (thumbnail, medium, full)
  • No manual product entry on your side
  • Simple API-key authentication

Available tools

Use these tools to integrate our catalogue, request returns, download files and send documents securely.

Available

Product database integration

Connect your website to our product database to display live products and images on your own site.

Read the user manual
Available

Download product database

Download the complete product catalogue in Excel format using the current website language.

Sign in to download Excel

Catalog Excel export is limited to administrators with product access.

Available

RMA request

Request a return, repair or replacement. Upload photos and track your case by RMA number.

Start RMA request
Available

Anonymous PDF catalogue

Download a professional PDF catalogue of all products with no company branding, in your current language.

Available

File uploader

Securely upload files such as purchase orders, quotes and technical documents.

User manual

Follow these steps to request access, create credentials, connect your website and display products from our catalogue.

Step-by-step guide

A clear path from access request to ongoing maintenance.

  1. Request access

    Contact our team or use your customer account to request access to product database integration. Once approved, you can create and manage API credentials as described in this guide.

    Keep your company contact details up to date so we can notify you about API changes.

  2. Create an API key

    Generate a dedicated API key for your website or application.

    • Create a named connection (for example “Partner website”).
    • Copy the API key immediately — it is shown only once.
    • Store it in a secure secrets manager; never commit it to a public repository.
  3. Connect your website

    Add the connection settings in your CMS, middleware or custom code:

    • API base URL: https://www.ic-electronics.com/api/v1
    • Authentication: send X-Api-Key: YOUR_API_KEY or Authorization: Bearer YOUR_API_KEY
    • Confirm a successful call to /api/v1/health, then /api/v1/products
  4. Import or display products

    Use the API to list products and load full details:

    • Show product name, SKU, description, family and subfamily
    • Load specifications, colours, accessories, packaging and logos
    • Render images with object-fit: contain (never crop) using thumbnail, medium or full URLs
    • Refresh periodically so your site stays synchronized with active products only
  5. Maintain your connection

    Rotate credentials when staff change, monitor usage, and revoke keys that are no longer needed. If a key is exposed, disable it immediately and create a replacement.

API documentation

Use these endpoints to retrieve active products and image variants from Media Manager. Only published (active) products are returned.

API URL https://www.ic-electronics.com/api/v1
Authentication API key (X-Api-Key or Bearer token)

Include your secret API key in every product request. The health endpoint is public for connectivity checks.

Endpoints

Method Path Description
GET /api/v1/health Health check (no authentication required).
GET /api/v1/products Paginated list of active products.
GET /api/v1/products/{id} Full product detail including images and related options.

Available fields

Field Type Description
id integer Product ID
sku string Product SKU / reference
name string Product name
description string Full description
short_description string Short description
family string Product family name
subfamily string Product subfamily name
specifications array Label/value specification pairs
colors array Available colours
accessories array Related accessories
packing array Packaging options
logos array Logo / marking options
images array Image objects with thumbnail, medium, full and fit=contain
url string Canonical product URL on ic-electronics.com

Example request

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

Example response

{
  "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"
      }
    }
  ]
}

Integration code example

Minimal browser/Node example that loads products with an API key.

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
}

Replace YOUR_API_KEY with the secret generated for your connection.

Frequently asked questions

Quick answers about product database integration.

What products are included?

Only active products are published through the API. Draft or disabled products are never returned.

How should images be displayed?

Use the provided thumbnail, medium or full URLs and always keep the aspect ratio with object-fit: contain. Do not crop or distort images.

Can I create multiple API keys?

Yes. Create one key per website or environment so you can revoke access independently.

Where do I get support?

Contact our team via the Contact page if you need credentials, higher rate limits or help with integration. Email info@ic-electronics.com or call +34 942 086 630.

Ready to connect your catalogue?

Request access or talk to our team about product database integration.

Accessibility

Adjust display settings for your comfort. Preferences are saved on this device.

Color modes
Text size