Akeneo PIM REST API 产品信息管理接口

接入教程

1. 注册Akeneo账户并获取API密钥
2. 使用API密钥进行身份验证
3. 调用产品端点创建或更新产品信息
4. 使用筛选参数查询特定产品数据
5. 设置Webhook接收数据变更通知
6. 集成到现有系统实现自动化同步

使用 Python 获取产品列表

python

import requests

url = 'https://api.example.com/api/rest/v1/products'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()
    products = response.json()
    print(f'Fetched {len(products["items"])} products')
except requests.exceptions.RequestException as e:
    print(f'Error fetching products: {e}')

使用 PHP 创建新产品

php

<?php
$url = 'https://api.example.com/api/rest/v1/products';
$apiKey = 'YOUR_API_KEY';
$data = [
    'identifier' => 'product_001',
    'enabled' => true,
    'family' => 'clothing'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error: ' . curl_error($ch);
} else {
    echo 'Product created successfully';
}
curl_close($ch);
?>

使用 JavaScript 更新产品属性

javascript

const url = 'https://api.example.com/api/rest/v1/products/product_001';
const apiKey = 'YOUR_API_KEY';
const updateData = {
    'values': {
        'name': [{'locale': 'zh_CN', 'scope': null, 'data': '更新产品名称'}]
    }
};

fetch(url, {
    method: 'PATCH',
    headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(updateData)
})
.then(response => {
    if (!response.ok) throw new Error('Update failed');
    return response.json();
})
.then(data => console.log('Product updated:', data))
.catch(error => console.error('Error:', error));

常见问题

如何获取 Akeneo PIM REST API 的访问令牌？

访问令牌通常通过 OAuth 2.0 客户端凭证流程获取。您需要在 Akeneo PIM 中创建应用程序客户端，使用客户端 ID 和密钥向认证端点请求令牌。请参考官方文档获取具体步骤。

API 请求频率是否有限制？

是的，Akeneo PIM REST API 通常设有速率限制以防止滥用，具体限制取决于您的订阅计划或配置。建议在代码中实现适当的重试逻辑，并查阅 API 文档了解具体的限制策略。

支持哪些数据格式进行产品数据的导入和导出？

Akeneo PIM REST API 主要支持 JSON 格式进行数据传输。对于批量操作，可以使用特定的端点进行导入和导出，如产品、属性或分类数据。确保数据符合 API 定义的架构。