عندما تحتاج إلى مفتاح
يعمل زر الشراء بدون أي مفتاح على الإطلاق — إنه يتحدث إلى نقاط نهاية عامة ومحدودة النطاق بالمشروع. المفتاح للطريق الآخر: الاستدعاءات التي تقدمها من الخادم الخاص بك، حيث تنشئ دفع أو تقرأ حالة المعاملة في الكود. تعيش المفاتيح تحت تبويب مفاتيح API الخاص بمشروعك.
إنشاء مفتاح
انقر فوق إنشاء مفتاح، وأعطها اسماً ستتذكره لاحقاً — عادة حيث يعمل، مثل "خادم الإنتاج" — وانقر فوق إنشاء مفتاح. الاسم هو فقط تسمية بالنسبة لك؛ إنه لا يغير ما يمكن للمفتاح القيام به (المفتاح محدود الاختصاص بهذا المشروع).
انسخها مرة واحدة
يُعرض المفتاح مرة واحدة فقط، مباشرة بعد إنشاؤك. يبدأ بـ cmk_. انسخها الآن وخزّنها في مكان آمن — نحتفظ فقط بـ hash، لذلك لا يمكننا عرضه لك مرة أخرى. افقده ويمكنك ببساطة إنشاء واحدة جديدة وحذف القديمة.
عامل المفتاح مثل كلمة المرور. استخدمه فقط من كود الخادم، وأرسله في رأس Authorization كرمز حامل، ولا تضعه أبداً في صفحة ويب أو مستودع عام أو أي شيء يُرسل إلى متصفح المشتري. يمكن لأي شخص لديه المفتاح التصرف نيابة عن مشروعك.
استخدام والقائمة وإلغاء السماح
يتم إدراج المفاتيح المحفوظة حسب الاسم وبادئة مقنعة وتاريخ الإنشاء. لا ترى المفتاح الكامل مرة أخرى — البادئة كافية فقط لتمييزهم. أيقونة سلة المهملات تلغي السماح بمفتاح على الفور: أي كود لا يزال يستخدمه يبدأ في الرفض، لذا يدور بإنشاء المفتاح الجديد أولاً ونشره ثم حذف القديم.
لما يمكنك استدعاؤه بالمفتاح — إنشاء دفع من الكود الخاص بك، والتعامل مع الأحداث، والاستقصاء عن الحالة — انظر استخدام API.