سجل التغييرات

ترقيم دلالي. التغييرات الكاسرة (إعادة تسمية الحقول، إزالة نقاط النهاية، تغيير نظام المصادقة) تأتي فقط في إصدار رئيسي جديد تحت بادئة URL جديدة /v2/. ضمن /v1/ تحدث فقط تغييرات إضافية (حقول اختيارية جديدة، نقاط نهاية جديدة).

v1.1.0 (2026-09-23)

• POST /v1/orders: يقبل config_options فقط الخيارات والقيم الظاهرة في المتجر، والكميات ضمن حدودها فقط. تحصل الخيارات الظاهرة التي لا تحددها على أول قيمة مدرجة، تمامًا كما في المتجر. ويعرض GET /v1/products/{id} الخيارات القابلة للطلب فقط ويعيد quantity.min وquantity.max.
• حالة طلب جديدة awaiting_setup مع الحقل awaiting_setup للمنتجات التي يجهزها فريق KernelHost يدويًا. تُجهَّز الخدمات التلقائية مرة واحدة بالضبط.
• يقتصر حجم body الطلبات على 64 كيلوبايت (HTTP 413). يسري حد قدره 120 طلبًا في الدقيقة لكل حساب عبر جميع المفاتيح، ويمكن للحساب امتلاك ما يصل إلى 20 مفتاحًا نشطًا. لم تعد المصادقة الفاشلة تقفل أي مفتاح، وأصبح Idempotency-Key مرتبطًا بالطريقة والمسار.
• كانت الطلبات التي تحتوي على أكثر من معامل في سلسلة الاستعلام (مثل GET /v1/services?limit=10&offset=0) تُرفض برمز HTTP 401. يشمل التوقيع الآن سلسلة الاستعلام تمامًا كما هو موثّق.

v1.0.0 (2026-05-14)

• الإصدار الأول. كل نقاط النهاية الـ 15، مصادقة HMAC، تخزين السر بـ AES-GCM، حدود المعدل، عَدَمية الأثر، سجل التدقيق.
• GET /v1/me, /v1/products, /v1/products/{id}
• POST /v1/orders, GET /v1/orders/{id}
• GET /v1/services, /v1/services/{id}, /v1/services/{id}/credentials
• POST /v1/services/{id}/actions
• GET /v1/billing/balance, /v1/billing/invoices, /v1/billing/invoices/{id}/pdf
• GET/PUT /v1/webhooks
• HMAC-SHA256 signing, AES-256-GCM secret storage, replay protection, idempotency.