उपयोग का उदाहरण
AliExpress रिव्यू अपने BigCommerce स्टोर में इम्पोर्ट करें
BigCommerce के पास रिव्यू API है, और AliExpress के पास रिव्यू। एक छोटी स्क्रिप्ट से दोनों को जोड़ें और आपके प्रोडक्ट्स को नेटिव रिव्यू मिल जाएँगे।
दो API, एक स्क्रिप्ट
BigCommerce आपको Catalog API से प्रोडक्ट रिव्यू बनाने देता है, इसलिए आपकी तरफ़ स्क्रैप करने को कुछ नहीं है और स्टोर में इंस्टॉल करने को भी कुछ नहीं। आपको बस साफ़ फ़ॉर्मैट में रिव्यू चाहिए, जो यह API लौटाता है।
इस तरह बने रिव्यू सामान्य BigCommerce रिव्यू होते हैं: आपकी थीम और आपके प्रोडक्ट पेजों की स्टार रेटिंग उन्हें किसी भी अन्य रिव्यू की तरह इस्तेमाल करती हैं।
यह कैसे काम करता है
- AliExpress प्रोडक्ट ID ढूँढें URL में:
aliexpress.com/item/1005006123456789.htmlमें मौजूद नंबर। - रिव्यू चुनें
filterसे: स्टार रेटिंग, फ़ोटो वाले रिव्यू या किसी देश के रिव्यू। - उनका अनुवाद करें
langके साथ ताकि वे आपके स्टोरफ़्रंट की भाषा में हों। - उन्हें बनाएँ
POST /v3/catalog/products/{id}/reviewsसे, products scope वाले BigCommerce API टोकन के साथ।
उदाहरण: AliExpress से BigCommerce रिव्यू तक
एक Node.js स्क्रिप्ट जो किसी AliExpress प्रोडक्ट के 5-स्टार रिव्यू पढ़ती है और उन्हें BigCommerce प्रोडक्ट के रिव्यू के रूप में बनाती है। अपना store 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 टोकन दोनों सीक्रेट हैं: स्क्रिप्ट, serverless फ़ंक्शन या cron का उपयोग करें।
- BigCommerce की रेट लिमिट का सम्मान करें और रिव्यू एक-एक करके या छोटे बैच में बनाएँ।
- डुप्लिकेट से बचें: जो AliExpress रिव्यू id आप बना चुके हैं उन्हें सहेजें।
- मॉडरेशन: उन्हें अपनी पसंद के स्टेटस के साथ बनाएँ (पहले देखने के लिए
pending, प्रकाशित करने के लिएapproved)।
इनका ईमानदारी से उपयोग करें
इन्हें AliExpress खरीदारों के प्रोडक्ट रिव्यू के रूप में दिखाएँ, आपके ग्राहकों के रिव्यू के रूप में नहीं। कई देशों में उपभोक्ता कानून के तहत आपको बताना होता है कि आपके रिव्यू कहाँ से आते हैं, और भरोसा भी इसी से बनता है।
सवाल
मुझे BigCommerce की कौन-सी अनुमति चाहिए?
स्टोर-स्तर का एक API अकाउंट जिसका टोकन Catalog scope में प्रोडक्ट्स बदल सकता हो। टोकन को रिव्यू API key की तरह सर्वर पर रखें।
क्या मैं रिव्यू की फ़ोटो इम्पोर्ट कर सकता हूँ?
Max प्लान पर, filter=image सिर्फ़ फ़ोटो वाले रिव्यू लौटाता है और उनके इमेज URL शामिल करता है। BigCommerce के रिव्यू endpoint में इमेज फ़ील्ड नहीं है, इसलिए उन्हें टेक्स्ट में जोड़ें या खुद होस्ट करें।
मुझे कितने रिव्यू मिल सकते हैं?
Free पर हर रिक्वेस्ट में 20 तक और Pro व Max पर 100 तक, सभी रिव्यू तक पहुँचने के लिए पेजिनेशन के साथ। प्लान के अनुसार कोटा हर दिन 100, 1,000 या 10,000 रिक्वेस्ट है।
क्या यह API AliExpress से संबद्ध है?
नहीं। यह वे सार्वजनिक रिव्यू लौटाता है जो AliExpress अपने प्रोडक्ट पेजों पर दिखाता है, लेकिन यह एक स्वतंत्र सेवा है।
अपने प्रोडक्ट्स के साथ आज़माएँ
हर दिन 100 रिक्वेस्ट मुफ़्त, कार्ड की ज़रूरत नहीं। अपने डैशबोर्ड के टेस्टर में किसी प्रोडक्ट का ID पेस्ट करें और JSON देखें।