مقدمة
يفشل الاتصال بعد أن يرسل نظام التكامل طلبًا. تشير واجهة المستخدم إلى إعادة المحاولة، فيقوم النظام بإنشاء مفتاح طلب جديد. يكمن قلق المشتري في ما إذا كانت المحاولة الثانية ستكرر العملية نفسها أم ستنشئ عملية جديدة، في حين أن نتيجة المحاولة الأولى غير مؤكدة. هذه حالة قبول افتراضية، وليست عملية دفع فعلية أو استنتاجًا حول مورد.
مرجع طلبات Stripe المتكررة يشرح هذا المستند، الذي نُشر بتاريخ ١١ أكتوبر ٢٠٢٦ عبر أداة التوثيق العامة الخاصة به، كيف تدعم المفاتيح عمليات إعادة الإرسال الآمنة. ويُفرّق النص الحالي بين واجهة برمجة التطبيقات (API) الإصدار الأول (API v1) وواجهة برمجة التطبيقات (API v2). ويقتصر نطاق قواعد الاحتفاظ بالنتائج التفصيلية في هذا المقال على واجهة برمجة التطبيقات (API v1) بدلاً من تقديمها كسياسة موحدة لشركة Stripe.
استخدم هذا الدليل فقط إذا كان مقترح المشروع الفعلي يتضمن تكامل واجهة برمجة تطبيقات Stripe ذات الصلة. لا تُثبت قوائم معدات WEIMI العامة توافقها مع Stripe. الأجهزة الثلاثة المرشحة أدناه هي قائمة مختصرة خاصة بالشركة المصنعة دون اختبار مستقل. تأكد من نطاق مزود الدفع والبرمجيات بشكل منفصل.
إجابة سريعة
بالنسبة لعملية API v1 نفسها، اطلب دليلاً على أن إعادة المحاولة تحتفظ بالمفتاح والمعلمات ضمن نطاق الاحتفاظ الموثق. تُفيد Stripe بأنها تحفظ رمز الحالة الأول ونص الاستجابة بعد بدء تنفيذ نقطة النهاية، وتُعيد تلك الاستجابة المحفوظة عند إعادة المحاولة باستخدام المفتاح نفسه، بما في ذلك أخطاء 500. إعادة المحاولة لا تضمن نجاحاً جديداً.
ينبغي على مزود الخدمة تحديد كيفية تمييز تطبيقه بين إعادة محاولة عملية غير مؤكدة وبدء عملية جديدة تمامًا. لا يؤدي استخدام مفتاح جديد إلى إعادة ربط المحاولة بالنتيجة الأصلية المحفوظة. زر "إعادة المحاولة" هو مجرد نص في واجهة المستخدم؛ لذا يُرجى مراجعة النتيجة المرجوة من العمل والتحقق من هوية الطلب.
يرجى التأكد من إصدار واجهة برمجة التطبيقات (API) وحدود الاحتفاظ بالبيانات قبل قبول العرض التوضيحي. يشير المصدر إلى أن إعادة استخدام مفتاح بعد حذف إدخاله الأصلي يُنشئ طلبًا جديدًا. كما يصف حالات لا يتم فيها حفظ أي نتيجة لأن التنفيذ لا يبدأ أبدًا. تتطلب هذه الحالات شرحًا منفصلاً لكيفية استرداد البيانات.
جدول المقارنة
يوضح الجدول حقائق واجهة برمجة التطبيقات (API) الإصدار الأول من المرجع المذكور. هذه أسئلة قبول مقترحة يتحكم بها المورد، وليست نتائج مُلاحظة لتكامل حقيقي لأنظمة البيع الآلي.
| قضية | قاعدة مصدر API v1 | طلب تقديم الأدلة | تجنب الافتراض |
|---|
| نفس المفتاح والمعلمات بعد التنفيذ | تم حفظ الحالة والنص. | المحاولات المرتبطة والنتيجة المحفوظة | كل محاولة إعادة حساب النجاح |
| نفس المفتاح مع تغيير المعلمات | ينتج عن مقارنة المعلمات خطأ | نتيجة عدم تطابق آمنة | يمكن لمفتاح واحد أن يمثل عملية التحرير |
| إعادة استخدام المفتاح بعد التقليم | تم إنشاء طلب جديد | حدود الاحتفاظ والاسترداد الموثقة | المفتاح يوفر إزالة التكرار بشكل دائم |
| فشل التحقق قبل التنفيذ | لم يتم حفظ أي نتيجة متكررة | تصنيف حالات الفشل وشرح إعادة المحاولة | يتم الاحتفاظ بكل رد |
| تعارض في الطلبات المتزامنة قبل التنفيذ | لم يتم حفظ أي نتيجة من هذا التعارض | أدلة الاسترداد التي يتحكم بها مقدم الخدمة | الصراع يعني إتمام إجراء تجاري |
| تم تقديم واجهة برمجة التطبيقات الإصدار الثاني بدلاً من ذلك. | تم توثيق دلالات إعادة المحاولة المختلفة | مراجعة منفصلة للإصدار الثاني الحالي | قاعدة الخطأ المخزن مؤقتًا v1 العالمية |
من ينبغي عليه شراء هذا المنتج؟
استخدم هذا الموجز لاقتراح سير عمل واضح لإنشاء أو تحديث بيانات باستخدام واجهة برمجة تطبيقات Stripe الإصدار الأول (Stripe API v1) مرتبط بمشروع بيع آلي. حدد نقطة النهاية الفعلية والغرض التجاري من الاقتراح. لا تُحدد إمكانية الدفع غير النقدي تطبيق واجهة برمجة التطبيقات أو الإصدار المستخدم.
ينبغي على صاحب العمل تحديد العملية المقصودة وما يُعتبر عملية جديدة. كما ينبغي على مزود التكامل تحديد كيفية إنشاء المفاتيح، وحفظ المعلمات، والوعي بالاحتفاظ بالبيانات، واستعادة البيانات في حال عدم اليقين بشأن النتائج. ويجب أن يكون فريق الدعم على دراية بالإجراءات الواجب اتخاذها عندما تُعيد محاولة إعادة الاتصال خطأً مُحتفظًا به بدلًا من نجاح جديد.
يُساعد هذا الدليل في الحالات التي تتوقف فيها العروض التوضيحية بعد إتمام الطلب بنجاح. اطلب دليلًا مُحكمًا لاستعادة الاتصال في حالة الفشل باستخدام عناصر اختبار غير ضارة. لا تُنشئ عملية دفع أو تُعيد محاولة إجراء معاملة حقيقية غير مؤكدة لمجرد إكمال قائمة التحقق من المشتريات.
كيف نقوم بتقييم آلات البيع الذكية
نستخدم بيانات منتجات WEIMI العامة المحفوظة والتي تمت مراجعتها في 10 أكتوبر 2026. نقارن خيارات الوصول والتوزيع في متاجر التجزئة. لم يتم التحقق من أي نقطة نهاية Stripe أو مفتاح طلب أو آلية استرداد لأي جهاز مدرج، ولم يتم إجراء أي استدعاء API لهذه المقالة.
أولاً، حدد نطاق عقد البرنامج. حدد مزود التكامل، وإصدار واجهة برمجة التطبيقات، وعملية الإنشاء أو التحديث الفعلية. افصل استعادة الطلبات الصادرة عن معالجة الطلبات المكررة الواردة عبر Webhook. لا يُعدّ عرض الحدث الوارد الصحيح دليلاً على أن الطلب الصادر يحتفظ بهويته.
ثانيًا، اطلب ربطًا آمنًا بين المحاولتين. يجب على المزوّد إثبات أن المحاولتين تنتميان إلى عملية واحدة مُرادة، مع ثبات المعايير واحتفاظه بالنتيجة المناسبة. استخدم مراجع اختبارية بدلًا من السجلات المالية الحقيقية أو البيانات الشخصية الحساسة المُضمّنة في المفاتيح.
ثالثًا، راجع الحدود. أدرج الأخطاء المحفوظة، والمعايير المتغيرة، وخطة موثقة للتعامل مع حالات عدم اليقين التي تتجاوز فترة الاحتفاظ. قواعد واجهة برمجة التطبيقات (API) الإصدار الأول للمصدر ليست إجراءً كاملاً لمطابقة الأعمال. اسأل المزوّد عن كيفية التحقق من الحالة الفعلية قبل اتخاذ قرار بشأن الإجراء الجديد المُبرر.
وأخيرًا، احتفظ بسياق النشر. سجّل الإصدار ونقطة النهاية والبنية للحالات الموضحة. إذا قام المزوّد بتغيير واجهة برمجة التطبيقات إلى الإصدار الثاني أو غيّر سير العمل، فأعد فتح المراجعة ذات الصلة بدلاً من نقل استنتاج الإصدار الأول دون إشعار.
عوامل الشراء الرئيسية
تتطلب إحدى العمليات هوية إعادة محاولة ثابتة. يصف Stripe مفتاحًا فريدًا يُنشئه العميل لتحديد عمليات إعادة المحاولة اللاحقة لنفس الطلب. ويقترح المرجع استخدام معرّفات عشوائية كافية، ويحذر من تضمين بيانات حساسة في المفاتيح. استفسر عن كيفية قيام مزود الخدمة بإنشاء هذه الهوية والاحتفاظ بها دون استخدام عناوين البريد الإلكتروني أو المعرّفات الشخصية.
يجب أن تظل المعلمات متسقة. في واجهة برمجة التطبيقات الإصدار الأول (API v1)، تقارن طبقة التكرارية المعلمات الواردة بالمعلمات الأصلية، وتُبلغ عن أي اختلاف. ينبغي على المزوّد التمييز بين المدخلات المصححة أو المُعدّلة والعملية التي لم يطرأ عليها تغيير والتي يُعاد تنفيذها. إن إعادة استخدام مفتاح مع تغيير المبلغ أو أي حقل آخر لا يُعد آلية تحرير آمنة مُثبتة.
تتضمن النتائج المحفوظة الأخطاء. يشير المصدر إلى أن واجهة برمجة التطبيقات (API v1) تحفظ رمز الحالة الأول ونص الاستجابة بعد بدء التنفيذ، بما في ذلك أخطاء 500. لذا، فإن تكرار الخطأ لا يُعدّ بحد ذاته دليلاً على فشل المفتاح. اطلب شرحًا للنتائج المحفوظة وخطة منفصلة لحل هذا الغموض التجاري.
مدة الاحتفاظ محدودة. تشير المراجع إلى إمكانية إزالة مفاتيح API v1 تلقائيًا بعد مرور 24 ساعة على الأقل من تاريخ إنشائها. في حال حذف المفتاح الأصلي، فإن إعادة استخدامه يُنشئ طلبًا جديدًا. لا تضمن حماية دائمة، ولا تفترض اختفاء جميع المفاتيح بعد 24 ساعة بالضبط. سجّل مدة استعادة المفتاح لدى المزوّد.
بعض حالات الفشل لا تُحفظ نتائجها. تُشير Stripe إلى أن فشل التحقق أو تعارضه مع طلب آخر قيد التنفيذ في الوقت نفسه لا يحفظ نتيجةً قابلةً للتكرار لأن التنفيذ لم يبدأ بعد. يجب على مزود الخدمة توضيح كيفية تصنيف تطبيقه لهذه الحالات وإعادة محاولتها. لا تُساوِ كل خطأ HTTP بعملية مُخزّنة مؤقتًا.
نطاق الأسلوب محدد. يشير مرجع API v1 إلى أن جميع طلبات POST تقبل المفاتيح، وأن المفاتيح لا تؤثر على طلبات GET أو DELETE، والتي يصفها بأنها متكررة بطبيعتها. اربط قبول المفاتيح بالطلب الموثق الفعلي بدلاً من إضافة مفاتيح إلى كل أسلوب كضمان.
واجهة برمجة التطبيقات الإصدار الثاني (API v2) فرع منفصل. يشير المرجع الحالي إلى أن محاولات إعادة التشغيل في الإصدار الثاني لا تُكرر العمليات الناجحة، وقد تُعيد محاولة العمليات الفاشلة أو التي فشلت جزئيًا حتى اكتمالها، مع إرجاع استجابة مُحدثة أو خطأ توضيحي. وهذا يختلف عن قاعدة الاستجابة المُحتفظ بها في الإصدار الأول (v1). لا يُغطي هذا الدليل تقييم الإصدار الثاني (v2).
لا تزال مطابقة البيانات التجارية مهمة. لا يضمن سلوك إعادة المحاولة القائم على المفاتيح صحة إجراءات المخزون أو المحاسبة أو الخزائن. استفسر عن كيفية ربط المزوّد لنتيجة الطلب بالحالة التجارية الفعلية، وكيفية تصعيد النتائج غير المحسومة. لا يوجد هنا ضمان كامل لإتمام المعاملة من البداية إلى النهاية.
أفضل آلات البيع الذكية
تصف هذه القوائم العامة ثلاثة نماذج حقيقية لمتاجر التجزئة. وهي لا تؤكد دعم Stripe، أو إصدار واجهة برمجة التطبيقات، أو إمكانية استعادة الطلبات. اطلب التكوين النهائي للأجهزة واقتراح تكامل مكتوب منفصل.
مرشح مبيعات التجزئة 1
ثلاجة ذكية بباب واحد مزودة بتقنية الذكاء الاصطناعي للمشروبات المعبأة
يصف الإعلان خاصية التعرف على الكاميرا، وخمسة مستويات رفوف مع خمس سلال، وشاشة علوية أو صندوق إضاءة. تأكد من إعدادات التبريد والعرض. هذا النوع من الأجهزة مخصص لبيع المنتجات المعبأة بالتجزئة بدلاً من تحضير العصائر.
في حال اقتراح سير عمل Stripe، حدد بدقة مهمة الإنشاء/التحديث وعلاقتها بسجلات المشغل. لا تحدد تقنية التعرف إصدار واجهة برمجة التطبيقات أو استعادة الطلبات. احتفظ بتجارب التعرف على الطرود منفصلة.
اقرأ القائمة العامة مرشح مبيعات التجزئة 2
آلة بيع الوجبات الخفيفة والمشروبات WM22
تصف الصفحة شاشة لمسية مقاس 21.5 بوصة، ونظام تبريد، وإدارة المخزون. تتطلب خيارات التعبئة الحلزونية، والناقلة، والدفع المباشر، والتعليق تأكيد الطلب. جرّب العبوات الفعلية مع الآلية المختارة.
بالنسبة لخدمة الدفع المضمنة، استفسر عن الجهة المسؤولة عن الطلبات الصادرة غير المؤكدة، وكيف يميز التطبيق بين إعادة المحاولة والعملية الجديدة. لا توفر شاشة اللمس أي تكامل مع المعالج أو إمكانية التحكم عن بُعد.
اقرأ القائمة العامة مرشح مبيعات التجزئة 3
خزانتان، خيارات أكثر: محطة بيع الوجبات الخفيفة والمشروبات
تعرض الصفحة خزانة عرض رئيسية ومنطقة تخزين حلزونية مرئية أخرى. لم يتم تحديد البرامج المشتركة، ونظام التبريد المستقل، والسعة الدقيقة هنا. يرجى تأكيد المحطة المقترحة بالكامل.
في حال اقتراح خدمة مشتركة، حدد العملية الفعلية وسجل نطاقها. لا يؤدي وجود منطقتي بيع إلى إنشاء حساب معالج واحد أو مخزن مفاتيح إعادة محاولة مشترك. اطلب أدلة تدعم البنية المقترحة.
اقرأ القائمة العامة مقارنة الميزات
يدعم تنسيق الأجهزة اختيار المعدات. وتندرج استعادة الطلبات ضمن التكامل المُقدّم صراحةً، ولا يمكن استنتاجها من ميزات الخزانة العامة.
| مُرَشَّح | تنسيق عام | طلب التكامل | حدود الأدلة |
|---|
| ثلاجة ذكية | التقدير والوصول إلى الرفوف | إنشاء/تحديث مهمة العمل الفعلية | لم يتم استنتاج إصدار واجهة برمجة التطبيقات |
| WM22 | خيارات شاشة اللمس والآليات | صاحب الطلبات غير المؤكدة | لا يوجد دعم للمعالج بشكل واضح |
| محطة مزدوجة | الخزانة الرئيسية ومنطقة تخزين إضافية | نطاق الخدمة والسجلات الحقيقية | لم يتم استنتاج وجود مخزن مفاتيح مشترك |
تحليل التكلفة والعائد على الاستثمار
ميزانية القبول الافتراضية: بافتراض 50 دقيقة لتحديد العملية وهوية إعادة المحاولة، و55 دقيقة لمراجعة الأدلة التي يتحكم بها مقدم الخدمة، و30 دقيقة لتسجيل حدود الاسترداد. إجمالي الوقت 135 دقيقة، أو ساعتان وربع. بافتراض أن تكلفة الساعة 42 دولارًا أمريكيًا، تبلغ تكلفة العمالة 94.50 دولارًا أمريكيًا.
لنفترض أن مراجعة لاحقة مدتها 30 دقيقة بنفس السعر تكلف 21 دولارًا أمريكيًا. يبلغ إجمالي المبلغ المخصص للتوضيح 115.50 دولارًا أمريكيًا. هذه افتراضات تخطيطية افتراضية، وليست رسوم معالجة أو أسعار WEIMI أو تكاليف اختبار فعلية.
لا يشمل الرسم التوضيحي التنفيذ والاستضافة والتقييم المتخصص. يُرجى الحصول على عروض أسعار فعلية. لا يتوقع الرسم أي رسوم مكررة أو زيادة في المبيعات أو استرداد تكلفة المعدات. يتطلب عائد الاستثمار في قطاع التجزئة معرفة الطلب الفعلي في الموقع وهوامش الربح وتكاليف التشغيل.
الخيار الأفضل حسب السيناريو
فشل الاتصال بعد إرسال الطلب: دليل مُتحكَّم به على إعادة محاولة الاتصال دون تغيير باستخدام الهوية الأصلية وحالة العمل الناتجة. لا تفترض أن عدم وجود استجابة يُثبت أن العملية الأولى لم تبدأ أبدًا.
تُعيد المحاولة نفس الخطأ 500: استفسر عما إذا كانت هذه هي نتيجة واجهة برمجة التطبيقات المحفوظة الإصدار 1، وكيف يُعالج المزوّد حالة عدم اليقين. إن إنشاء مفاتيح جديدة بشكل متكرر لا يُعد دليلاً على أن العملية الأصلية قد تمت معالجتها بنجاح.
يقوم المشغل بتعديل المدخلات قبل إعادة المحاولة: اطلب تمييزًا واضحًا بين الطلب الأصلي والغرض التجاري المُعدَّل. يقارن الإصدار الأول من واجهة برمجة التطبيقات (API v1) المعلمات؛ ولا ينبغي اعتبار المفتاح المُعاد استخدامه مع معلمات مختلفة بمثابة إعادة محاولة عادية وشفافة.
قد يتم حذف المفتاح الأصلي: استفسر عن كيفية تحقق مزود الخدمة من الحالة الفعلية قبل أي طلب جديد محتمل. لا يُعدّ المفتاح وسيلة دائمة لإزالة التكرار. لا يُحدد هذا الدليل نتيجة المعاملة الفعلية.
يُقدّم المزوّد واجهة برمجة التطبيقات (API) الإصدار الثاني: يُرجى مراجعة قواعدها الحالية وآلية عملها بشكل منفصل. لا تُطبّق مناقشة نتائج التخزين المؤقت والتقليم الخاصة بالإصدار الأول دون تغيير.
التطبيقات
أنشئ سجل إعادة محاولة يتضمن الموفر، وإصدار واجهة برمجة التطبيقات، ونقطة النهاية الفعلية، والعملية المقصودة، ومرجع الهوية الآمنة، وقاعدة حفظ المعلمات، ودليل النتائج المحفوظة، ومالك الحالة غير المُحَلّة. هذا سجل شراء مُقترح، وليس ميزة مُدمجة في WEIMI.
اطلب من المزوّد المعتمد استخدام نماذج اختبار غير ضارة للحالات المتفق عليها. يجب أن يوضح هذا النموذج عملية ربط الطلب وإعادة المحاولة دون إجراء أي عملية دفع حقيقية أو التعامل مع بيانات شخصية حساسة. ينبغي على قسم المشتريات مراقبة الأدلة أو مراجعتها، وليس تجربة عملية إنتاج غير مؤكدة.
حافظ على التمييز بين الاستجابة المستلمة وإتمام العمل. أدرج حدود الإنشاء والاسترداد لكي يعرف المراجعون اللاحقون ما تم تحديده. يتطلب التعامل مع طلبات الويب الواردة دليلاً خاصاً به، ولا يُغلق هذا البند الخاص بالطلب الصادر.
عند تغيير الإصدار أو نقطة النهاية أو معايير العمل، أعد فتح حالات القبول ذات الصلة. قم بتكليف عمليات التوزيع والتعرف على الحزم والتبريد بشكل منفصل مقابل طلب الأجهزة. آلية إعادة المحاولة الآمنة هي خاصية برمجية وليست ضمانًا للمشروع بأكمله.
هل تُعيد واجهة برمجة التطبيقات الإصدار الأول نتيجة جديدة في كل محاولة إعادة استخدام نفس المفتاح؟
يقول المصدر إنه يعيد الحالة المحفوظة والنص بعد بدء التنفيذ، بما في ذلك أخطاء 500.
هل يمكن أن يمثل المفتاح نفسه معلمات متغيرة؟
تقوم واجهة برمجة التطبيقات الإصدار الأول (API v1) بمقارنة المعلمات والأخطاء عندما تختلف لمنع سوء الاستخدام العرضي.
هل يوفر المفتاح إزالة البيانات المكررة بشكل دائم؟
لا. إعادة استخدام مفتاح بعد حذف سجله الأصلي يؤدي إلى إنشاء طلب جديد.
هل يتم حفظ كل فشل كنتيجة متكررة لا يمكن تكرارها؟
يستثني المصدر فشل التحقق من الصحة والتعارض المتزامن قبل بدء التنفيذ.
هل قواعد واجهة برمجة التطبيقات (API) الإصدار الأول (v1) والإصدار الثاني (v2) متطابقة؟
لا. المرجع الحالي يميز بين دلالات إعادة المحاولة. يقتصر هذا الدليل على قواعد النتائج المحفوظة المفصلة الخاصة به في الإصدار الأول.
هل تتحقق الأجهزة الثلاثة من دعم Stripe؟
لا. تأكد من توافق المشروع ونطاق التكامل كتابيًا.
التوصية النهائية
يجب ضمان هوية ثابتة لنفس عملية واجهة برمجة التطبيقات (API v1)، مع الحفاظ على المعلمات دون تغيير، وتقديم دليل على النتائج المحفوظة ضمن نطاقها الفعلي. ينبغي تضمين حالات الخطأ والحذف في مناقشة الاسترداد بدلاً من الاكتفاء بضمان نجاح كل محاولة إعادة.
تأكد من عرض Stripe الفعلي وإصدار واجهة برمجة التطبيقات (API) بشكل منفصل عن اختيار الأجهزة. لا تتضمن هذه المقالة أي استدعاء لواجهة برمجة التطبيقات، ولا تُجري أي عملية دفع، ولا تُنشئ أي آلية لاستعادة الطلبات للأجهزة المختارة.
