تخطَّ إلى المحتوى
+ أضف منتج إنشاء حساب تسجيل الدخول

مصمم مفاتيح الإلغاء التكراري

هندسة API والتكاملات agent-skills rest MIT
⬇ تنزيل vsha-bf813f0dd77d

SHA-256: bf813f0dd77de5f7d2015b78dfae6fa66aa288a9b6deac116754f11a333608f1 2 كيلوبايت

✦ جاهزة لبيئة عملك

ثبّت هذه المهارة مباشرة داخل وكيلك

اختر الوكيل، انسخ الأمر، وشغّله من مجلد مشروعك. يتولى CLI تنزيل الحزمة والتحقق من بصمة SHA-256 ووضع الملفات في المسار المناسب.

$npx @ai-dalil/skills add idempotency-key-designer --agent codex

@ai-dalil/skills على npm - Node.js 18.18 أو أحدث.

↓ تنزيل ZIP · الإصدار sha-bf813f0dd77d بيانات API ↗ سجل الإصدارات ↗

الوصف

عربي

يطبق مفاتيح إلغاء تكرار صحيحة: توليد لدى العميل، تخزين نتيجة، وردود متطابقة للنداءات المكررة.

English

Implement proper idempotency keys: client-side generation, result storage, and identical responses to duplicate calls.

بيانات المهارة التقنية

SKILL name
idempotency-key-designer
الوصف الأصلي
Implement proper idempotency keys: client-side generation, result storage, and identical responses to duplicate calls.
إصدار المهارة
1.3.0
التوافق
اتصال شبكة · مفاتيح API من المستخدم
الأدوات المسموح بها
Read, Write
الكلمات المفتاحية
idempotency, reliability, api, payments
لغة المصدر
multilingual
الفرع / المرجع
main
دليل الترخيص
Original editorial content authored for the AiDalil catalog and released under MIT by the catalog owner. (high)

بيانات المصدر الأصلية (YAML)

عرض Frontmatter الأصلي
name: idempotency-key-designer
description: Implement proper idempotency keys: client-side generation, result storage, and identical responses to duplicate calls.
version: 1.3.0
metadata:
  author: AiDalil Editorial
  category: api-integration
  compatibility: claude-code, crush, github-copilot, roo-code, kilo-code, api
  difficulty: advanced
  tags: [idempotency, reliability, api, payments]

تعليمات SKILL.md

المحتوى الأصلي للمهارة كما ورد من المصدر، مع الحفاظ على تنسيق Markdown.

عرض التعليمات الكاملة
# Idempotency Key Designer

**Goal:** Implement proper idempotency keys: client-side generation, result storage, and identical responses to duplicate calls.

> الهدف: يطبق مفاتيح إلغاء تكرار صحيحة: توليد لدى العميل، تخزين نتيجة، وردود متطابقة للنداءات المكررة.

## When to use
- الحالة النموذجية: يطبق مفاتيح إلغاء تكرار صحيحة: توليد لدى العميل، تخزين نتيجة، وردود متطابقة للنداءات المكررة.
- معالجة تضارب مزامنة البيانات بين نظامين.
- تصميم سلوك إعادة المحاولة والتعامل مع الأعطال.
- مراجعة أمان ربط الدفع أو الهوية أو الرسائل.
- توثيق أخطاء واجهة برمجية بشكل قابل للتصرف.

## Workflow
1. خطط للأخطاء: كل رمز خطأ خارجي له تصرف داخلي محدد.
2. حدّد التكامل: مصمم مفاتيح الإلغاء التكراري. اذكر الأطراف واتجاه البيانات ومتطلبات الاتساق.
3. وثّق سجل التكامل: الإعدادات، الحدود، وسلوك التعافي.
4. صمّم العقد: الحقول، الصيغ، القيم الافتراضية، وحالات الفراغ.
5. أضف المهلة وإعادة المحاولة مع تراجع تدريجي وحماية من العواصف.
6. اقرأ المواصفة الرسمية للمزود وسجّل الحدود والقيود والأسعار.
7. اختبر الحالات الحقيقية: بطء، فشل جزئي، تكرار، وترتيب مخالف.
8. طبّق الهوية الآمنة وتجديد الرموز دون تعطيل الطلبات الجارية.

## Rules
- كل رسالة خطأ خارجية تُترجم إلى معنى داخلي موحد.
- خطة تعطيل المزود مكتوبة: ماذا يعمل وماذا يتوقف؟
- النداءات المتكررة بعد فشل يجب أن تكون آمنة على البيانات.
- أسرار المزود في مخزن آمن ولا تُسجل في السجلات.
- لا تكامل بلا مهلة صريحة لكل نداء خارجي.

## Output contract
- جدول أخطاء خارجية وترجمتها الداخلية.
- دليل تشغيل التكامل ومراقبته.
- سيناريوهات اختبار فشل ونتائجها.
- إعدادات مهلة وإعادة محاولة مبررة.

## Quality checks
- [ ] هل السجلات تتيح تشخيص نداء فاشل دون كشف أسرار؟
- [ ] هل إعادة المحاولة لا تضاعف الأثر المالي أو الرسائل؟
- [ ] هل التوثيق الداخلي يطابق المواصفة الرسمية الحالية؟
- [ ] هل سلوك تجديد الرموز مختبر قبل انتهاء الصلاحية؟
- [ ] هل كل المسارات تتعامل مع انتهاء المهلة والفشل الجزئي؟

## Skill identity
- Skill name: `idempotency-key-designer`
- Version: 1.3.0
- Domain: API and Integration Engineering (هندسة API والتكاملات)
- Tags: idempotency, reliability, api, payments

التثبيت اليدوي

استخدم هذا المسار عند عدم استخدام CLI أو عند إدارة ملفات المهارات يدويًا.

  1. نزّل ملف ZIP للإصدار المطلوب من أعلى الصفحة، أو افتح المصدر الأصلي إذا لم تتوفر حزمة مستضافة.
  2. فك الضغط، ثم انقل مجلد المهارة الذي يحتوي مباشرة على SKILL.md إلى مجلد الوكيل.
  3. أعد تحميل الوكيل أو افتح جلسة جديدة، ثم تأكد من ظهور المهارة ضمن المهارات المتاحة.
Codex.agents/skills/idempotency-key-designer/
Claude Code.claude/skills/idempotency-key-designer/
Cursor.cursor/skills/idempotency-key-designer/

تعليمات خاصة بهذه المهارة

Extract the skill folder into your agent's skills directory (for example the project skills folder) or install the ZIP package from the skill page. No build step is required; everything is Markdown.

حالات الاستخدام

• مراجعة أمان ربط الدفع أو الهوية أو الرسائل. • دمج مزود خدمة خارجي في المنتج بأمان. • توثيق أخطاء واجهة برمجية بشكل قابل للتصرف.

المتطلبات

• Any Agent Skills compatible assistant (Claude Code, Claude Desktop, or API agents). • Basic file access to read the bundled reference playbook. • No external services required for the standard workflow.

الإصدارات

الإصدار الحجم الملفات تاريخ النشر تنزيل
vsha-bf813f0dd77d 2 كيلوبايت 2 4 نوفمبر، 2026 تحميل

الأمان والفحص

فحص أساسي ✓ — 1 نوفمبر، 2026

مجتمع يبني قدرات أفضل

هل طوّرت مهارة تستحق أن يكتشفها الآخرون؟

ساهم في إثراء مكتبة المهارات، وعرّف المجتمع على عملك مع حفظ نسبه إلى مصدره الأصلي.

أرسل مهارة كيف تعمل المهارات؟
قسم المهارات — دليل AIالعودة إلى دليل AI ↗