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

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.