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

KernelHost API

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

v1.4.0 (2026-11-09)

  • مسار جديد GET /v1/services/{id}/metrics (الصلاحية read:services): مقاييس الخادم للفترات 1h و6h و24h و7d و14d. توفر Edge Unlimited Traffic VPS بيانات المعالج والذاكرة والشبكة وحركة المرور الصادرة، وتوفر Unlimited Traffic VPS العادية حركة الشبكة الواردة والصادرة في المواقع المذكورة في مرجع نقاط النهاية.
  • مساران جديدان GET /v1/services/{id}/ddos/attacks وGET /v1/services/{id}/ddos/attacks/{attack_id} (الصلاحية read:ddos): تقارير هجمات لخدمة Remote DDoS Protection لمدة تصل إلى 90 يومًا، مع منحنى حركة المرور وتوزيعات حسب البروتوكول والمنفذ والمصدر وحجم الحزم.
  • ملفات الحماية والقواعد (/ddos/profiles و/ddos/rules وعمليات الكتابة): الخدمة التابعة لحسابك التي ليست خدمة Advanced DDoS Protection تعيد الآن HTTP 409 not_supported_for_product بدلًا من HTTP 404. وتظل معرّفات الخدمات غير المعروفة أو التي لا تملكها تعيد HTTP 404.

v1.3.1 (2026-11-02)

  • يمكنك اختيار ألمانيا وفرنسا كلًّا على حدة: يضع خيار «ألمانيا (أوروبا)» الخادم في ألمانيا فقط، في فرانكفورت، وخيار «فرنسا (أوروبا)» في فرنسا فقط.
  • قد يستغرق تجهيز خوادم Unlimited Traffic VPS العادية في مواقع أوروبا وألمانيا وفرنسا وشرق كندا والمملكة المتحدة وبولندا ما يصل إلى 7 أيام. في معظم الحالات يكون الخادم جاهزًا خلال 48 ساعة. تبدأ مدة الاشتراك المدفوعة عند استلام الخادم فقط.

v1.3.0 (2026-11-02)

  • Advanced DDoS Protection: قراءة ملفات الحماية والقواعد، وإضافة القواعد وحذف قواعدك عبر أربعة مسارات جديدة. فعّل read:ddos وwrite:ddos صراحة؛ لا تحصل المفاتيح الحالية على صلاحيات جديدة.
  • تحمي الحدود المشتركة بين اللوحة وAPI وتنفيذ التغييرات بالتتابع وإلزام Idempotency-Key في POST وDELETE من الإرسال المكثف للقواعد والطلبات المتوازية.

v1.2.2 (2026-10-27)

  • POST /v1/orders: إذا تعذّر تجهيز خدمة مدفوعة على الفور، يظهر معرّفها الآن في الحقل awaiting_setup (مع status بقيمة awaiting_setup) بدلًا من provisioning_failures مع status بقيمة partial. ويتم تجهيز الخدمة تلقائيًا بمجرد أن يصبح ذلك ممكنًا، ثم تنتقل حالتها إلى active. ولا تُعِد تقديم الطلب في هذه الحالة.

v1.2.1 (2026-10-26)

  • Dedicated Unlimited Traffic VPN: مواقع جديدة برسوم إضافية في أوروبا والأمريكتين وآسيا والشرق الأوسط وأفريقيا وأستراليا. يعرضها GET /v1/products/{id} باسم العرض والرسوم الإضافية. وإذا كان أحد هذه المواقع نافدًا حاليًا، يُرجع POST /v1/orders الرمز HTTP 409 location_sold_out. وعند عدم تحديد موقع، يبقى أول موقع مدرج (Europe) هو المعتمد.
  • حصلت الخيارات القابلة للتهيئة (الموقع ونظام التشغيل) في باقتي Dedicated Unlimited Traffic VPN وDedicated High Speed Unlimited Traffic VPN على معرّفات جديدة، وكذلك خياراتها الفرعية. اقرأ المعرّفات من GET /v1/products/{id}، فالمعرّف القديم المثبّت في الشيفرة يُرجع HTTP 400 validation_failed. أما خدمات هاتين الباقتين التي كانت قيمة status فيها cancelled أو terminated أو fraud قبل هذا التغيير، فأصبحت قيمة location لها في GET /v1/services/{id} هي null. ولم يعد طلب High Speed VPN ممكنًا إلا مع خيارات الموقع «Europe» و«Germany or France» و«Canada East (Beauharnois)» و«France (Europe)» و«United Kingdom (Europe)» و«Poland (Europe)».
  • Edge Unlimited Traffic VPS: ستة مواقع جديدة (فرانكفورت أم ماين ولندن وتشيستر وباريس ووارسو وواشنطن العاصمة)، ليصل المجموع إلى 25 موقعًا كحد أقصى. للمواقع الجديدة قيم sub_option_id خاصة بها، وتبقى معرّفات المواقع الحالية كما هي. وفي بعض الباقات أُعيد توزيع السعر الأساسي والرسوم الإضافية للمواقع، مع بقاء الأسعار الإجمالية للمواقع الحالية دون تغيير. اقرأ المعرّفات والأسعار دائمًا من GET /v1/products/{id}.

v1.2.0 (2026-10-24)

  • POST /v1/orders للمنتجات التي يُختار فيها الموقع (Edge Unlimited Traffic VPS): لا يملك خيار الموقع قيمة افتراضية ويجب إرساله ضمن config_options، وإلا يُرجع الخادم HTTP 422 مع reason بقيمة location_required. ويُرجع الموقع النافد HTTP 409 location_sold_out. يحدد الحقل الاختياري الجديد storage_gb سعة التخزين الإجمالية بين 20 و300 GB. وتشمل الباقة 20 GB ضمن سعرها، وتُطبَّق عند عدم إرسال الحقل، ويُحتسب كل GB إضافي بالسعر الوارد في GET /v1/products/{id}. وأي قيمة أخرى تُرجع HTTP 422 storage_out_of_range.
  • تتضمن نتيجة الطلب لهذه المنتجات الحقلين location وstorage_gb (سعة التخزين الإجمالية بوحدة GB)، ويصف GET /v1/products/{id} في الحقل storage نطاق التخزين وسعر كل GB إضافي. ويُرجع GET /v1/services وGET /v1/services/{id} الحقلين location وstorage_gb لكل خدمة (null إذا لم يكن للمنتج مثل هذا الاختيار).
  • يُرجع GET /v1/products/{id} الخيارات الفرعية باسم العرض فقط (مثل "Finland (Europe)")، دون القيمة الداخلية التي كانت تسبقه. ويرفض POST /v1/orders المنتجات النافدة حاليًا بالرمز HTTP 409 out_of_stock.

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.