充分利用我们的产品数据
工具专区汇集面向客户的集成能力。从产品数据库集成开始，获取在售产品、规格、颜色、配件、包装、标识与 Media Manager 中的图片，无需手工重新录入。
- 始终保持最新的产品信息
- 自动获取产品图片（缩略图、中图、原图）
- 无需在您一侧手工录入产品
- 简单的 API 密钥认证
工具
可用工具
使用这些工具集成产品目录、提交退换货、下载文件并安全发送文档。
匿名 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。