skill
ترقية Stripe
دليل لترقية إصدارات Stripe API، ونقاط نهاية الويب هوك، وحزم SDK من جانب الخادم، وStripe.js، وحزم SDK للأجهزة المحمولة.
نبذة
# ترقية إصدارات Stripe
## اختر إصدار API مستهدفا
إذا حدد المستخدم إصدار API مستهدفا، فاستخدمه. بخلاف ذلك، ابحث عن الإصدار الحالي على docs.stripe.com باستخدام أي وثائق أو أداة ويب متاحة لك، على سبيل المثال `stripe docs /api/versioning` باستخدام Stripe CLI. تنص صفحة [API versioning](https://docs.stripe.com/api/versioning.md) على ذلك في الجملة التي تبدأ ب "The current version is".
إصدار API احتياطي مجمع: `2026-10-28.endive`. هذه القيمة هي لقطة فقط من آخر مرة تم فيها إنشاء هذه المهارة، في 2026-11-16. تبدأ معرفات الإصدار بتاريخ إصدارها بتنسيق YYYY-MM-DD ويتم إصدار إصدارات مستقرة جديدة شهريا، لذا فإن إصدارا احتياطيا يعود تاريخه إلى أكثر من شهر مضى من المحتمل أن يكون قديما. استخدمه فقط عندما لا تتمكن من الوصول إلى docs.stripe.com. لا تخمن أبدا رقم إصدار أحدث.
قبل إجراء التغييرات، قارن الهدف بكل إصدار API تحدده عملية التكامل: تكوين العميل، التجاوزات لكل طلب، ونقاط نهاية الويب هوك. ما لم يطلب المستخدم ذلك صراحة، لا تنقل أي تثبيت إلى إصدار أقدم أو تثبيت مستقر إلى إصدار معاينة. إذا كان التثبيت يطابق الهدف بالفعل، فأبلغ عنه على أنه لم يتغير. اذكر الهدف المحدد ومصدره. إذا فشل التحقق المباشر أو كان غير متاح، فقل إن أحدث إصدار لا يزال غير متحقق منه، ولا تدعي أن التكامل على أحدث إصدار.
عند مراجعة نقاط نهاية الويب هوك ووجهات الأحداث، ميز أحداث اللقطة عن الأحداث الخفيفة. حمولات الأحداث الخفيفة غير مصدرة، لذا لا تحتاج إلى ترقيتها عند تغيير إصدار API الخاص بك. تظل استدعاءات API التي تسترد الحدث الكامل أو المورد ذي الصلة مصدرة.
بالنسبة ل SDKs التي تدعم تجاوزات إصدار API الصريحة، استخدم الهدف المحدد في تكوين العميل والتجاوزات لكل طلب. استخدمه في رؤوس اختبار `Stripe-Version` ل curl أيضا. استبدل إصدارات API المجمعة المعروضة في تلك الأمثلة بالهدف المحدد قبل نسخها أو تشغيلها. بالنسبة ل Java و Go و .NET، حدد إصدار SDK يستهدف إصدار API المحدد بدلا من تجاوز الإصدار الثابت ل SDK. تتطلب أهداف المعاينة إصدار SDK `beta` المطابق في كل لغة؛ راجع [SDK versioning](https://docs.stripe.com/sdks/versioning.md).
## فهم إصدارات Stripe API
تستخدم Stripe إصدارات API قائمة على التاريخ (على سبيل المثال، `2026-10-28.endive`، `2025-08-27.basil`، `2024-12-18.acacia`). يحدد إصدار API لحسابك سلوك الطلب/الاستجابة.
بدءا من إصدار 2024-09-30.acacia، تصدر Stripe إصدارات API جديدة شهريا بدون تغييرات كاسرة. مرتين في السنة، يبدأ إصدار رئيسي جديد (على سبيل المثال، Basil) بإصدار API يحتوي على تغييرات كاسرة. يمكنك الترقية بأمان إلى أي إصدار شهري دون تحديث التعليمات البرمجية الخاصة بك.
### أنواع التغييرات
**التغييرات المتوافقة مع الإصدارات السابقة** (لا تتطلب تحديثات التعليمات البرمجية):
- موارد API جديدة - معلمات طلب اختيارية جديدة - خصائص جديدة في الاستجابات الموجودة - تغييرات في أطوال السلاسل المعتمة (على سبيل المثال، معرفات الكائنات) - أنواع أحداث ويب هوك جديدة
**التغييرات الكاسرة** (تتطلب تحديثات التعليمات البرمجية):
- إعادة تسمية الحقول أو إزالتها - تعديلات سلوكية - إزالة نقاط النهاية أو المعلمات
راجع [سجل تغييرات API](https://docs.stripe.com/changelog.md) لجميع التغييرات بين الإصدارات. راجع [ترقيات API](https://docs.stripe.com/upgrades.md) للحصول على دليل الترقية الكامل.
## إصدارات SDK من جانب الخادم
راجع [تعيين إصدار Stripe API ل SDK الخاص بك](https://docs.stripe.com/sdks/set-version.md) للحصول على تفاصيل حول تعيين إصدار API في التعليمات البرمجية.
### اللغات ذات النوع الديناميكي (Ruby، Python، PHP، Node.js)
توفر هذه ال SDKs تحكما مرنا في الإصدار:
**التكوين العام:**
```python import stripe stripe.api_version = '2026-10-28.endive' ```
```ruby Stripe.api_version = '2026-10-28.endive' ```
```javascript const stripe = require('stripe')('sk_test_xxx', { apiVersion: '2026-10-28.endive' }); ```
**التجاوز لكل طلب:**
```python stripe.Customer.create( email="customer@example.com", stripe_version='2026-10-28.endive' ) ```
### اللغات ذات النوع القوي (Java، Go، .NET)
تستخدم هذه اللغات إصدار API ثابتا يطابق تاريخ إصدار SDK. لا تقم بتعيين إصدار API مختلف للغات ذات النوع القوي لأن كائنات الاستجابة قد لا تتطابق مع الأنواع القوية في SDK. بدلا من ذلك، قم بتحديث SDK لاستهداف إصدار API جديد.
### أفضل الممارسات
حدد دائما إصدار API الذي تقوم بدمجه في التعليمات البرمجية الخاصة بك بدلا من الاعتماد على إصدار API الافتراضي لحسابك:
```javascript // Good: Explicit version const stripe = require('stripe')('sk_test_xxx', { apiVersion: '2026-10-28.endive' });
// Avoid: Relying on account default const stripe = require('stripe')('sk_test_xxx'); ```
## إصدارات Stripe.js
راجع [إصدارات Stripe.js](https://docs.stripe.com/sdks/stripejs-versioning.md) للحصول على التفاصيل.
تستخدم Stripe.js نموذجا دائم التحديث مع إصدارات رئيسية (Acacia، Basil، Clover، Dahlia، Endive) على أساس نصف سنوي.
### تحميل Stripe.js المصدرة
**عبر علامة Script:**
```html <script src="https://js.stripe.com/endive/stripe.js" ```
التثبيت
شغل هذا الأمر
npx skills add stripe/aiيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add stripe/ai`، أو استنسخ المستودع وانسخ مجلد `skills/upgrade-stripe` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة ترقية Stripe؟
دليل لترقية إصدارات Stripe API، ونقاط نهاية الويب هوك، وحزم SDK من جانب الخادم، وStripe.js، وحزم SDK للأجهزة المحمولة.
كيف أثبت ترقية Stripe؟
شغل هذا الأمر في الطرفية:
npx skills add stripe/aiمع أي أدوات ذكاء اصطناعي تعمل ترقية Stripe؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور ترقية Stripe؟
طورها stripe.
هل ترقية Stripe مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add microsoft/azure-skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى