充分利用我们的产品数据
工具专区汇集面向客户的集成能力。从产品数据库集成开始，获取在售产品、规格、颜色、配件、包装、标识与 Media Manager 中的图片，无需手工重新录入。
- 始终保持最新的产品信息
- 自动获取产品图片（缩略图、中图、原图）
- 无需在您一侧手工录入产品
- 简单的 API 密钥认证
工具
可用工具
使用这些工具集成产品目录、提交退换货、下载文件并安全发送文档。
下载产品数据库
以当前网站语言下载完整产品目录（Excel）。
Sign in to download ExcelCatalog Excel export is limited to administrators with product access.
匿名 PDF 目录
下载全部产品的专业 PDF 目录，无公司品牌标识，使用当前语言。
文件上传
安全上传采购订单、报价与技术文件等。
用户手册
按以下步骤申请访问权限、创建凭证、连接网站并从我们的目录展示产品。
分步指南
从申请访问到持续维护的清晰流程。
-
申请访问权限
联系我们的团队或使用客户账户申请产品数据库集成访问权限。获批后，您可按本指南创建和管理 API 凭证。
请保持公司联系方式最新，以便我们通知 API 变更。
截图占位 -
创建 API 密钥
为您的网站或应用生成专用 API 密钥。
- 创建命名连接（例如“合作伙伴网站”）。
- 立即复制 API 密钥——仅显示一次。
- 保存在安全的密钥管理中；切勿提交到公开仓库。
截图占位 -
连接您的网站
在 CMS、中间件或自定义代码中添加连接设置：
- API 基础 URL：
https://www.ic-electronics.com/api/v1 - 认证：发送
X-Api-Key: YOUR_API_KEY或Authorization: Bearer YOUR_API_KEY - 先确认
/api/v1/health调用成功，再调用/api/v1/products
截图占位 - API 基础 URL：
-
导入或展示产品
使用 API 列出产品并加载完整详情：
- 显示产品名称、SKU、描述、系列与子系列
- 加载规格、颜色、配件、包装与标识选项
- 使用
object-fit: contain渲染图片（切勿裁剪），使用缩略图、中图或原图 URL - 定期刷新，使站点仅与在售产品保持同步
截图占位 -
维护连接
人员变动时轮换凭证，监控使用情况，并撤销不再需要的密钥。若密钥泄露，请立即停用并创建新密钥。
截图占位
API 文档
使用这些接口从 Media Manager 获取在售产品与图片变体。仅返回已发布（在售）产品。
接口
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/health |
健康检查（无需认证）。 |
| GET | /api/v1/products |
在售产品分页列表。 |
| GET | /api/v1/products/{id} |
完整产品详情，含图片与相关选项。 |
可用字段
| 字段 | 类型 | 说明 |
|---|---|---|
id |
integer | 产品 ID |
sku |
string | 产品 SKU / 编号 |
name |
string | 产品名称 |
description |
string | 完整描述 |
short_description |
string | 简短描述 |
family |
string | 产品系列名称 |
subfamily |
string | 产品子系列名称 |
specifications |
array | 规格标签/值对 |
colors |
array | 可用颜色 |
accessories |
array | 相关配件 |
packing |
array | 包装选项 |
logos |
array | 标识 / 打标选项 |
images |
array | 含 thumbnail、medium、full 且 fit=contain 的图片对象 |
url |
string | ic-electronics.com 上的规范产品 URL |
请求示例
GET https://www.ic-electronics.com/api/v1/products?page=1&per_page=24
X-Api-Key: YOUR_API_KEY
Accept: application/json响应示例
{
"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"
}
}
]
}集成代码示例
使用 API 密钥加载产品的最小浏览器/Node 示例。
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
}将 YOUR_API_KEY 替换为您连接所生成的密钥。
常见问题
关于产品数据库集成的快速解答。
包含哪些产品？
API 仅发布在售产品。草稿或已停用产品不会返回。
应如何显示图片？
使用提供的缩略图、中图或原图 URL，并用 object-fit: contain 保持比例。请勿裁剪或拉伸图片。
可以创建多个 API 密钥吗？
可以。为每个网站或环境创建一把密钥，以便独立撤销访问权限。
如何获得支持？
如需凭证、更高限额或集成协助，请通过联系页面联系我们。邮箱 info@ic-electronics.com，电话 +34 942 086 630。