المفاتيح والباقات

افتح حساب مطور من لوحة المطورين، وأنشئ مفتاحًا باسم يدل على مكانه (خادم الإنتاج، خادم التجربة). يظهر المفتاح مرة واحدة: انسخه واحفظه في متغير بيئة على خادمك، ولا نحتفظ إلا ببصمته.

أرسله في كل طلب:

Authorization: Bearer wsm_live_…

أو في X-API-Key. المفتاح في الرابط يُرفض بـ 400، لأن الروابط تبقى في السجلات والتاريخ. وإن ظننت أن مفتاحًا تسرّب، ألغِه من حسابك فيتوقف فورًا، وأنشئ غيره.

السحب هو سجل علامة واحد يُرجع بنجاح من /api/v1/brands/{slug}: الاسم والوصف والألوان والنسخ وروابط الملفات كلها. 404 و308 لا تُحسب، والبحث والقائمة لا تُحسب ولها حد الطلبات في الدقيقة فقط.

كل رد سجل فيه:

• X-Quota-Limit: سحوبات الشهر المسموحة.
• X-Quota-Used: ما استُخدم منها.
• X-Quota-Reset: متى يبدأ الشهر التالي، بالثواني منذ 1970 (Unix).

الشهر شهر ميلادي بتوقيت الرياض.

الباقة المجانية تتوقف عند حدها: يُرد 402 حتى بداية الشهر التالي.

الباقات المدفوعة تحدد سعرًا لكل سحب بعد المضمّن فيها، ولا يُحسب إلا ضمن سقف الإنفاق الذي تحدده أنت. حين يُبلغ السقف يُرد 402 حتى ترفعه أو يبدأ شهر جديد، فلا تصلك فاتورة لم توافق عليها.

صفحات وسمينيا نفسها (البحث، والفلاتر، ومختبر هذه الصفحات) تطلب بلا مفتاح كعرض تجريبي: السجل يأتي بلا روابط الملفات الأصلية، مع "access": "demo"، وبحد طلبات لكل عنوان. وأي طلب آخر بلا مفتاح يُرفض بـ 401.