Skip to Content
مرجع APIسجل التغييرات

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

عمليات CRUD كاملة على مدخلات سجل التغييرات في مشروعك.

GET/v1/changelog

ParameterTypeDescription
localestringإعادة المدخلات بهذه اللغة عند وجود ترجمة.
limitintegerحجم الصفحة. الافتراضي 20.
offsetintegerعدد العناصر المراد تخطّيها. الافتراضي 0.

يعيد السرد المدخلات المنشورة فقط — المجموعة نفسها التي يراها زائر البوابة.

GET/v1/changelog/:id

ParameterTypeDescription
localestringإعادة المدخل بهذه اللغة عند وجود ترجمة.

POST/v1/changelog

ParameterTypeDescription
titlerequiredstringعنوان المدخل.
bodystringمتن المدخل (Markdown).
labelsstring[]تسميات مثل New أو Improved أو Fixed.
versionstringإصدار semver. الافتراضي 1.0.0.
statusstringdraft أو scheduled أو published. الافتراضي draft.
localestringلغة المحتوى. الافتراضي en.

PATCH/v1/changelog/:id

ParameterTypeDescription
titlestringعنوان المدخل.
bodystringمتن المدخل (Markdown).
labelsstring[]تسميات مثل New أو Improved أو Fixed.
versionstringإصدار semver. الافتراضي 1.0.0.
statusstringdraft أو scheduled أو published. الافتراضي draft.
localestringلغة المحتوى. الافتراضي en.

DELETE/v1/changelog/:id

تتطلّب الكتابات وصول API بخطة مدفوعة Pro. ويعيد DELETE الرمز 204 بجسم فارغ.

سرد مدخلات سجل التغييرات

curl "https://api.supdesk.app/v1/changelog?locale=en&limit=20" \ -H "Authorization: Bearer sd_live_..."
{ "data": [ { "id": "ch_abc123", "title": "Version 1.4.0", "body": "### New Features\n\n- Added dark mode support\n- New export options\n\n### Fixes\n\n- Fixed Safari export button issue", "labels": ["new", "fixed"], "published_at": "2026-07-01T12:00:00Z", "locale": "en", "version": "1.4.0" } ], "pagination": { "limit": 20, "offset": 0, "has_more": false } }

جلب مدخل من سجل التغييرات

curl "https://api.supdesk.app/v1/changelog/ch_abc123?locale=en" \ -H "Authorization: Bearer sd_live_..."
{ "data": { "id": "ch_abc123", "title": "Version 1.4.0", "body": "### New Features\n\n- Added dark mode support\n- New export options\n\n### Fixes\n\n- Fixed Safari export button issue", "labels": ["new", "fixed"], "published_at": "2026-07-01T12:00:00Z", "locale": "en", "version": "1.4.0" } }

إنشاء مدخل في سجل التغييرات

curl -X POST https://api.supdesk.app/v1/changelog \ -H "Authorization: Bearer sd_live_..." \ -H "Content-Type: application/json" \ -d '{ "title": "Version 1.4.0", "body": "### New Features\n\n- Added dark mode support\n- New export options\n\n### Fixes\n\n- Fixed Safari export button issue", "labels": ["new", "fixed"], "version": "1.4.0", "status": "published", "locale": "en" }'
{ "data": { "id": "ch_abc123", "title": "Version 1.4.0", "body": "### New Features\n\n- Added dark mode support\n- New export options\n\n### Fixes\n\n- Fixed Safari export button issue", "labels": ["new", "fixed"], "published_at": "2026-07-01T12:00:00Z", "locale": "en", "version": "1.4.0" } }

تحديث مدخل في سجل التغييرات

curl -X PATCH https://api.supdesk.app/v1/changelog/ch_abc123 \ -H "Authorization: Bearer sd_live_..." \ -H "Content-Type: application/json" \ -d '{ "title": "Version 1.4.0 - Enhanced", "status": "draft" }'
{ "data": { "id": "ch_abc123", "title": "Version 1.4.0 - Enhanced", "body": "### New Features\n\n- Added dark mode support\n- New export options\n\n### Fixes\n\n- Fixed Safari export button issue", "labels": ["new", "fixed"], "published_at": null, "locale": "en", "version": "1.4.0" } }

حذف مدخل من سجل التغييرات

curl -X DELETE https://api.supdesk.app/v1/changelog/ch_abc123 \ -H "Authorization: Bearer sd_live_..."

يعيد 204 No Content عند النجاح.

Last updated on