Skip to main content
لا تستخدم البادئة Bearer. يُرسل المفتاح كما هو دون أي بادئة. إضافة Bearer تؤدي إلى إرجاع 401، وهذا هو الخطأ الأكثر شيوعًا على الإطلاق في الاستدعاء الأول.

نوعان من بيانات الاعتماد، وترويسة واحدة

مفتاح API — من Settings → Developers (الإعدادات ← المطوِّرون). نطاقه مقصور على المنظمة التي أنشأته. وهذا ما تحتاج إليه لبناء تكاملك الخاص. رمز وصول OAuth — يُصدر لتطبيق معتمد كي يتمكن أشخاص آخرون من ربط حساباتهم هم في نُشر بمنتجك. يُميَّز بالبادئة pos_، ويُستدل منه على المنظمة التي منحت الوصول. كلاهما يوضع في الترويسة نفسها؛ ويميّز الخادم بينهما من خلال البادئة.

النطاق

يتصرف المفتاح باسم المنظمة بأكملها. لا توجد أذونات لكل مفتاح على حدة — فالمفتاح القادر على القراءة قادر أيضًا على النشر وحذف المنشورات وفصل القنوات.

الحفاظ على أمانه

للاستخدام من جانب الخادم فقط. المفتاح الموجود في تعليمات المتصفح البرمجية يصبح علنيًا لحظة شحن الحزمة، ويمكنه فصل كل قناة في الحساب.
احتفظ به في متغير بيئة أو في مدير أسرار. وإذا تسرّب أحد المفاتيح، فألغِه من Settings → Developers — يسري الإلغاء فورًا.

التحقق من صلاحية المفتاح

تعني 200 أن المفتاح صالح. وتعني 401 أنه مفقود، أو خاطئ، أو مسبوق ببادئة.