الوثائقالمفاتيح والنطاقات والأرصدة4 دقيقة قراءة

المفاتيح والنطاقات والأرصدة

نموذج التهديد صريحٌ لا مجاملة فيه: أي مفتاحٍ يصل إلى جهازٍ فهو مفتاحٌ عام. وكل ما في هذه الصفحة مترتّب على هذه الجملة.

  • لا نحتفظ من المفتاح إلا ببصمة لا تُعكس، لا بالمفتاح نفسه. فاستخراج قاعدة البيانات لا يمنح أحدًا مفاتيح عاملة، ولا يستطيع الدعم قراءة مفتاحك — أعد توليده بدل ذلك.
  • يُعرض المفتاح مرة واحدة عند الإنشاء، ولا تطبعه اللوحة بعد ذلك أبدًا.
  • الفرق بين live وtest ليس تلميحًا: يرفض مفتاح الاختبار الإنتاج، ولا يستهلك أحرف حقيقية.
  • لكل مشروع مفاتيحه، فتسرّب مفتاح تطبيق لا يكشف تطبيقاتك الأخرى، وإلغاء مفتاح لا يعطّل البقية.

النطاقات المسموحة

اترك القائمة فارغة فيُقبَل أي Origin — وهذا صائبٌ لخادم Node وخاطئٌ لتطبيق متصفح. وحدّد النطاقات التي تنشر إليها بالضبط، فيتوقّف المفتاح المنسوخ عند كل مضيفٍ آخر: تقارن الخدمة ترويسة Origin بالقائمة وتجيب 403 origin_not_allowed.

ما يحرسه الرصيد

  • تُعدّ الأحرف من النص الأصلي، مرة لكل نص جديد. والمعتمد يُعاد من الذاكرة مجانًا، فواجهة ثابتة تتوقف عن الكلفة.
  • طلبات الدقيقة تُقاس لكل مفتاح. وتوقف الحزمة نفسها عند 429 بقية الجلسة بدل الإلحاح.
  • وإذا فني العدّاد جاءك 402 وفيه usage، لا تدهور صامت. فيعرض تطبيقك نصّه الأصلي ويُعلَم المطور.

تدوير مفتاح تسرّب

  1. 1من «مفاتيح API» ألغِ المكشوف، فيموت فورًا في الذاكرة وخارجها.
  2. 2أنشئ بديلًا وانشره، واعتبر القديم سرًّا معلنًا بقية عمره؛ فهو في تاريخك وفي سجلّات غيرك.
  3. 3وأضف قائمة النطاقات قبل الإصدار القادم لا بعده.