إنشاء مفاتيح API وإدارتها بأمان: القراءة والكتابة والسحب

ما هو مفتاح API

مفتاح API سلسلة أحرف طويلة وعشوائية يعرّف بها برنامج نفسه أمام خدمة ما. من يعرفه يستطيع فعل كل ما يسمح به المفتاح. لذلك يجب حفظ مفتاح API بأمان مثل كلمة المرور. في Same-QR تحتاج إليه لسطر الأوامر sameqr، ولسكربتاتك الخاصة على واجهة REST API، ولوكلاء البرمجة مثل Claude Code وCursor وCodex. أما ChatGPT وClaude.ai فلا يحتاجان إليه، فهما يسجلان الدخول عبر OAuth.

الخطوة 1: العثور على المكان الصحيح

سجّل الدخول إلى لوحة التحكم وافتح الحساب. هناك قسم «الوصول لـ CLI والسكربتات والوكلاء». لا يمكن إنشاء المفاتيح إلا هنا، بتسجيل دخول في المتصفح. لا يستطيع مفتاح أن ينشئ مفاتيح أخرى، وبذلك لا يتكاثر مفتاح مسروق.

الخطوة 2: اختيار الصلاحيات

هناك ثلاثة مستويات. اختر دائمًا أصغر مستوى يكفي للمهمة.

• تقارير المسح والتحليلات ومساعد يجيب عن الأسئلة فقط: قراءة فقط.
• سكربتات تنشئ رموز QR وصفحات، وتغيّر الأسماء والنصوص، وتنشر، وتستورد البطاقات: قراءة + كتابة.
• سير عمل تغيّر وجهات رموز QR الموجودة، أو توقف الصفحات أو تحذفها: كامل. كل تغيير من هذا النوع يحتاج إلى تأكيد بالحالة المقروءة، وعبر الواجهة يُسمح بـ 10 في الساعة و30 في اليوم على الأكثر.

مع مفتاح قراءة يُرفض كل طلب يغيّر شيئًا. وكيل برمجة متصل عبر MCP بمفتاح قراءة لا يرى أدوات الكتابة أصلًا.

الخطوة 3: المدة والاسم

كل مفتاح ينتهي: بعد 30 أو 90 أو 180 أو 365 يومًا، والقيمة الافتراضية 90. يمكن أيضًا جعله بلا حد، لكن عليك اختيار ذلك عن قصد، مثلًا لمهمة ليلية دون بشر تجدده. أعطِ المفتاح اسمًا يدل على غرضه، مثل «تقرير شهري للعميل أ». يمكن إنشاء ما يصل إلى 10 مفاتيح لكل حساب.

الخطوة 4: احفظه بأمان فورًا

يبدأ المفتاح بـ sqr_live_ ويظهر مرة واحدة فقط. يخزّن Same-QR بصمة تحقق فقط ولا يستطيع أن يعرضه لك مرة أخرى لاحقًا. ضعه مباشرة في مدير كلمات المرور. تقرؤه البرامج عند التشغيل من متغير البيئة SAMEQR_API_KEY. المفتاح لا مكان له:

• في الشيفرة المصدرية، وخاصة ليس في مستودع عام،
• في عنوان، لأن العناوين تصل إلى السجلات والتاريخ،
• في جدول أو بريد إلكتروني أو رسالة دردشة،
• في الدردشة مع مساعد ذكي،
• كوسيط في أمر، لأنه يظهر حينها في سجل الأوامر في الطرفية.

للبداية الثابتة sqr_live_ غرض: الأدوات التي تبحث عن أسرار نُشرت بالخطأ تتعرف على المفتاح بها.

الخطوة 5: اسحبه عند الحاجة

في القائمة نفسها تسحب المفتاح بنقرة واحدة. يصبح غير صالح فورًا، وتبقى رموز QR الخاصة بك دون تغيير. تبقى المفاتيح المنتهية في القائمة مع ملاحظة، لتعرف لماذا لم يعد سكربت ما ينجح فجأة. كما أن تغيير كلمة المرور يسحب جميع المفاتيح دفعة واحدة. اسحب المفتاح إذا ظهر في أي مكان، أو إذا لم يعد مزود خدمة يعمل لأجلك، أو إذا لم تعد تعرف لماذا هو موجود.

الخلاصة: لماذا Same-QR

يأخذ Same-QR المفاتيح بجدية: صلاحيات منفصلة، ومدد بقيمة افتراضية معقولة، وعرض مرة واحدة فقط، وتخزين كبصمة تحقق فقط، وسحب بأثر فوري. وهكذا تستخدم واجهة API وCLI ووكلاء البرمجة بهدوء، في كل باقة.

ابدأ الآن: سجّل مجانًا على sameqr.com، فـ 20 رمز QR ديناميكيًا مجانية بشكل دائم. واجهة API وCLI وخادم MCP متاحة في كل باقة، والتوثيق على sameqr.com/entwickler.

الأسئلة الشائعة