سجل التغييرات
عمليات CRUD كاملة على مدخلات سجل التغييرات في مشروعك.
GET/v1/changelog
| Parameter | Type | Description |
|---|---|---|
locale | string | إعادة المدخلات بهذه اللغة عند وجود ترجمة. |
limit | integer | حجم الصفحة. الافتراضي 20. |
offset | integer | عدد العناصر المراد تخطّيها. الافتراضي 0. |
يعيد السرد المدخلات المنشورة فقط — المجموعة نفسها التي يراها زائر البوابة.
GET/v1/changelog/:id
| Parameter | Type | Description |
|---|---|---|
locale | string | إعادة المدخل بهذه اللغة عند وجود ترجمة. |
POST/v1/changelog
| Parameter | Type | Description |
|---|---|---|
titlerequired | string | عنوان المدخل. |
body | string | متن المدخل (Markdown). |
labels | string[] | تسميات مثل New أو Improved أو Fixed. |
version | string | إصدار semver. الافتراضي 1.0.0. |
status | string | draft أو scheduled أو published. الافتراضي draft. |
locale | string | لغة المحتوى. الافتراضي en. |
PATCH/v1/changelog/:id
| Parameter | Type | Description |
|---|---|---|
title | string | عنوان المدخل. |
body | string | متن المدخل (Markdown). |
labels | string[] | تسميات مثل New أو Improved أو Fixed. |
version | string | إصدار semver. الافتراضي 1.0.0. |
status | string | draft أو scheduled أو published. الافتراضي draft. |
locale | string | لغة المحتوى. الافتراضي 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