كتالوج المنتجات وواجهة API
منتجاتك، تقييماتك، أنظمتك.
أدِر بطاقات المنتجات التي ترتبط بها تقييماتك، واسترجع هذه التقييمات عبر واجهة REST لعرضها حيثما تشاء: متجرك الإلكتروني، أو نظام ERP، أو PIM، أو لوحة تحكم داخلية.
كتالوج يمتلئ تلقائيًا
تُضاف منتجاتك عند استيراد الطلبيات أو استلام عملية تسليم. لا تُدخل شيئًا بنفسك: يكفي أن تصحّح وتُكمل.
- تعديل الاسم والسعر والوصف بنقرة واحدة
- بحث فوري في الكتالوج بأكمله
- قائمة مقسّمة إلى صفحات تناسب الكتالوجات الكبيرة
رمز SKU، مفتاح تقييمات منتجاتك
هو المرجع الذي تعتمد عليه أدوات العرض واستدعاءات API للعثور على تقييمات المنتج. وبمجرد تحديده يصبح مقفلًا.
- لا يختفي أي تقييم من بطاقة منتج عن طريق الخطأ
- يبقى الاسم والسعر والوصف قابلة للتعديل بحرية
- طابِق رمز SKU مع رمز متجرك منذ الإدخال الأول
مفتاح واحد تحت تحكمك
لمؤسستك مفتاح نشط واحد يُرسل في ترويسة X-API-Key. أعِد توليده إذا شككت في تسريبه، وألغِه عندما لا تعود بحاجة إليه.
- يُعرض مرة واحدة فقط: لا تُخزَّن سوى بصمته
- تدوير المفتاح وإلغاؤه بنقرة واحدة من لوحة التحكم
- نقطة وصول عامة دون مفتاح للعرض على موقعك
curl -H "X-API-Key: YOUR_API_KEY" \ -H "Accept: application/json" \ ".../companies/{id}/products/{ref}/reviews"
ثلاث طرق للقراءة، بصيغة واحدة
منتج واحد، أو عدة منتجات دفعة واحدة، أو كتالوجك بأكمله: للاستجابة دائمًا البنية نفسها.
- متوسط التقييم وعدد التقييمات وترقيم الصفحات في كل استجابة
- عدة مراجع في طلب واحد، مفصولة بفواصل
- أمثلة جاهزة للنسخ بلغات cURL وPHP وJavaScript
{
"averageRating": 4.35,
"totalReviews": 23,
"page": 1,
"reviewsPerPage": 10,
"reviews": [ … ]
} كتالوج المنتجات وواجهة API للتقييمات: ربط تقييماتك بمتجرك
لا قيمة لتقييم المنتج إلا إذا ظهر على البطاقة الصحيحة. وهذا هو دور الثنائي كتالوج المنتجات وواجهة API: يحافظ الكتالوج على تحديث بطاقة كل منتج — الاسم والسعر والوصف ورمز SKU — وتتيح الواجهة البرمجية لأنظمتك الخاصة جلب التقييمات المرتبطة بكل مرجع.
لا يُملأ الكتالوج يدويًا. تُضاف منتجاتك إليه تلقائيًا عند استيراد طلبية أو وصول عملية تسليم عبر webhook من Yalidine أو Guepex. وتُستخدم شاشة «منتجاتي» بعد ذلك لتصحيح تسمية، أو تعديل سعر، أو إكمال وصف، والعثور على أي مرجع بالبحث.
يحتل رمز SKU مكانة خاصة. فهو المفتاح الذي يربط منتجًا في متجرك بالتقييمات المحفوظة لدى Cachet Thika: إذ تستعلم أدوات العرض واستدعاءات API عن المنصة بهذا المرجع. وتعديله لاحقًا سيؤدي إلى اختفاء التقييمات من بطاقة المنتج المعنية — ولهذا يصبح مقفلًا بمجرد تحديده، بينما تبقى الحقول الأخرى قابلة للتعديل بحرية. طابِقه مع رمز متجرك منذ الإدخال الأول.
أما من جهة واجهة API، فتغطي ثلاث طرق للقراءة معظم الاحتياجات: تقييمات منتج محدد، أو تقييمات عدة منتجات في طلب واحد بمراجع مفصولة بفواصل، أو جميع تقييمات مؤسستك. تكون الاستجابة دائمًا بصيغة JSON، وتتضمن متوسط التقييم والعدد الإجمالي للتقييمات وترقيم الصفحات وقائمة التقييمات. وتتم المصادقة بمفتاح يُرسل في ترويسة X-API-Key.
لا يُعرض المفتاح إلا عند إنشائه: لا تُحفظ سوى بصمته المشفرة، ما يجعله غير قابل للاسترجاع لاحقًا، حتى من طرف فريقنا. وإذا شككت في تسريبه، يولّد التدوير مفتاحًا جديدًا ويُبطل القديم فورًا. وللعرض البسيط على موقعك، تتوفر نقطة وصول عامة دون مفتاح: وهي التي تستخدمها أدوات العرض من Cachet Thika، ولا تكشف أي سر في المتصفح.
الأسئلة الشائعة
ما هو كتالوج المنتجات في Cachet Thika؟
هو شاشة «منتجاتي» في لوحة التحكم، حيث تدير بطاقة كل منتج يترك عملاؤك تقييمات عليه: الاسم والسعر والوصف ورمز SKU. تُضاف المنتجات تلقائيًا عند استيراد الطلبيات أو عند استلام عملية تسليم عبر webhook، ثم يُستخدم الكتالوج لتصحيحها وإكمالها والعثور عليها.
لماذا يُقفل رمز SKU بمجرد تحديده؟
لأن رمز SKU هو المفتاح الذي يربط منتجًا في متجرك بالتقييمات المعروضة على موقعك. إذ تستعلم أدوات العرض واستدعاءات API عن Cachet Thika بمرجع المنتج: وتغيير رمز SKU مستخدم مسبقًا سيؤدي إلى اختفاء التقييمات من بطاقة المنتج المعنية. أما الاسم والسعر والوصف فتبقى قابلة للتعديل في أي وقت.
كيف أسترجع تقييمات منتجاتي عبر واجهة API؟
توفر Cachet Thika نقاط وصول REST تُرجع بيانات بصيغة JSON. تولّد مفتاحًا من شاشة «مفاتيح API»، ثم ترسله في ترويسة HTTP المسماة X-API-Key. وتتوفر ثلاث طرق للقراءة: تقييمات منتج محدد، أو تقييمات عدة منتجات في طلب واحد بمراجع مفصولة بفواصل، أو جميع تقييمات مؤسستك.
ماذا تتضمن استجابة واجهة API لتقييمات المنتجات؟
كائن JSON يضم متوسط التقييم في الحقل averageRating، والعدد الإجمالي للتقييمات في الحقل totalReviews، وترقيم الصفحات في الحقلين page وreviewsPerPage، وقائمة التقييمات. ويتضمن كل تقييم درجته ومحتواه وتاريخه والاسم الأول لكاتبه ومرجع المنتج المعني. وهذه الصيغة قابلة للاستخدام مباشرة لتغذية بطاقة منتج أو محرك بحث داخلي أو لوحة تحكم خاصة.
هل أحتاج إلى مفتاح API لعرض التقييمات على موقعي؟
لا. تُرجع نقطة وصول عامة مخصصة التقييمات الموجهة للعرض دون مصادقة — وهي التي تستخدمها أدوات العرض من Cachet Thika. أما مفتاح API فمخصص للتكاملات بين الخوادم: مزامنة تقييماتك مع نظام ERP أو PIM أو مستودع بياناتك، حيث يجب ألا يُكشف الاستدعاء للمتصفح.
هل مفاتيح API آمنة؟
لا يُعرض المفتاح بشكل مقروء إلا عند إنشائه: إذ لا تحتفظ Cachet Thika إلا ببصمته المشفرة، ما يجعل قراءته لاحقًا مستحيلة، حتى على فريقنا. ولكل مؤسسة مفتاح نشط واحد، يمكنك إعادة توليده بنقرة واحدة إذا شككت في تسريبه، أو إلغاؤه لقطع أي وصول.
هل تتوفر أمثلة برمجية؟
نعم. تولّد شاشة «مفاتيح API» لكل نقطة وصول مثالًا جاهزًا للنسخ بلغة cURL، وبلغة PHP مع Guzzle، وبلغة JavaScript مع fetch، معبأً مسبقًا بمعرّف مؤسستك ومرجع المنتج الذي تُدخله. تلصقه، وتستبدل المفتاح، فيعمل مباشرة.
تقييماتك الموثّقة، داخل أنظمتك الخاصة.
كتالوج منتجات يحدّث نفسه تلقائيًا، وواجهة REST لجلب التقييمات حيثما تحتاج إليها.