使用场景
将 AliExpress 评价导入您的 BigCommerce 店铺
BigCommerce 有评价 API，而 AliExpress 有评价数据。用一个简短的脚本把两者连接起来，您的商品就有了原生评价。
两个 API，一个脚本
BigCommerce 允许您通过 Catalog API 创建商品评价，因此您这边无需抓取任何内容，店铺中也无需安装任何东西。您只需要格式干净的评价，而这正是本 API 所返回的。
以这种方式创建的评价就是普通的 BigCommerce 评价：您的主题和商品页面的星级评分会像使用其他评价一样使用它们。
使用方式
- 找到 AliExpress 商品 ID：即链接中的数字，例如
aliexpress.com/item/1005006123456789.html。 - 使用
filter选择评价：某个星级、带图评价，或来自某个国家的评价。 - 使用
lang翻译评价，使其与您店面的语言一致。 - 使用具有 products 权限范围的 BigCommerce API 令牌，通过
POST /v3/catalog/products/{id}/reviews创建评价。
示例：从 AliExpress 到 BigCommerce 评价
这是一个 Node.js 脚本，它读取某个 AliExpress 商品的 5 星评价，并将其创建为 BigCommerce 商品的评价。请设置您的店铺 hash、API 令牌和 BigCommerce 商品 ID。
// Create BigCommerce product reviews from the 5-star reviews of an AliExpress product.
const API = 'https://api.aliexpress-reviews.com';
const STORE_HASH = process.env.BC_STORE_HASH;
const BC_PRODUCT_ID = 123; // your BigCommerce product
const res = await fetch(`${API}/v1/reviews/1005006123456789?filter=5&pageSize=20`, {
headers: { 'x-api-key': process.env.REVIEWS_API_KEY },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const { data } = await res.json();
for (const r of data) {
const created = await fetch(
`https://api.bigcommerce.com/stores/${STORE_HASH}/v3/catalog/products/${BC_PRODUCT_ID}/reviews`,
{
method: 'POST',
headers: {
'X-Auth-Token': process.env.BC_ACCESS_TOKEN,
'Content-Type': 'application/json',
Accept: 'application/json',
},
body: JSON.stringify({
title: r.content.slice(0, 60),
text: r.content,
status: 'pending', // review them in the control panel, then approve
rating: r.rating,
name: r.author,
date_reviewed: new Date(r.date).toISOString(),
}),
},
);
if (!created.ok) console.error(r.id, created.status, await created.text());
}值得注意的细节
- 在服务器端运行。评价 API key 和 BigCommerce 令牌都是机密：请使用脚本、无服务器函数或 cron。
- 遵守 BigCommerce 的速率限制，按顺序或分小批创建评价。
- 避免重复：保存已创建的 AliExpress 评价 ID。
- 审核：以您偏好的状态创建评价（
pending表示先审核，approved表示直接发布）。
诚实地使用评价
请将这些评价呈现为 AliExpress 买家对该商品的评价，而非您的客户。许多国家的消费者保护法都要求您说明评价的来源，这同样是建立信任的方式。
常见问题
我需要哪种 BigCommerce 权限？
需要一个店铺级 API 账户，其令牌可在 Catalog 范围内修改商品。请像对待评价 API key 一样，将令牌保留在服务器端。
可以导入评价照片吗？
使用 Max 套餐时，filter=image 仅返回带图评价，并包含其图片 URL。BigCommerce 的评价接口没有图片字段，因此请将图片添加到文本中，或自行托管。
我可以获取多少条评价？
Free 套餐每次请求最多 20 条，Pro 和 Max 最多 100 条，并可通过分页获取全部评价。根据套餐不同，配额为每天 100、1,000 或 10,000 次请求。
该 API 与 AliExpress 有关联吗？
没有。它返回 AliExpress 在商品页面上展示的公开评价，但它是一项独立的服务。
用您自己的商品试一试
每天 100 次免费请求，无需银行卡。在控制台的测试工具中粘贴商品 ID，即可查看 JSON。