إعدادات المشروع

لكل مشروع إعدادات نشطة — القص، والخلفية، ونمط الترجمة، والتخطيط — تتحكّم في كيفية إخراج التصديرات. استخدم إعدادات المشروع عندما تريد تجاوزات محلية على مستوى المشروع لا تستحق مشاركتها كإعداد مسبق. راجع مرجع إعدادات العرض للحصول على خريطة الحقول المشتركة لـ preset وsettings.style وsettingsOverride.

نقاط النهاية

Method	Path	Purpose
`GET`	`/projects/{projectId}/settings`	جلب إعدادات المشروع النشطة.
`PATCH`	`/projects/{projectId}/settings`	تطبيق إعداد مسبق، أو تعديل الإعدادات، أو كلاهما.

مخططات الطلب والاستجابة الكاملة موجودة في مرجع API.

جلب الإعدادات الحالية

curl https://api.youka.io/ar/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..."

يعيد الإعدادات النشطة الكاملة للمشروع، بما في ذلك أي إعداد مسبق تم تطبيقه.

تعديل الإعدادات

يقبل PATCH أي مجموعة فرعية من presetId وsettings. عند تمريرهما معًا، يتم تطبيق الإعداد المسبق أولًا ثم يتم دمج settings فوقه.

تطبيق إعداد مسبق
إعدادات مضمّنة
إعداد مسبق + تجاوزات

curl -X PATCH https://api.youka.io/ar/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "presetId": "preset_abc123"
  }'

curl -X PATCH https://api.youka.io/ar/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "settings": {
      "trim": { "startSeconds": 5, "endSeconds": 180 },
      "style": {
        "background": {
          "type": "color",
          "color": "#101010"
        }
      }
    }
  }'

curl -X PATCH https://api.youka.io/ar/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "presetId": "preset_abc123",
    "settings": {
      "trim": { "startSeconds": 5, "endSeconds": 180 }
    }
  }'

اكتشاف الحقول الصالحة

تقوم SDK بتصدير المخطط الذي يتحقق من تحديثات إعدادات المشروع. حوّله إلى JSON Schema أثناء وقت التشغيل:

import { RestUpdateProjectSettingsRequestSchema } from "@youka/ar/sdk";

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();

ينبغي على الوكلاء جلب مخطط SDK أو مخطط طلب OpenAPI قبل تعديل إعدادات المشروع كي يعرفوا دائمًا البنية الحالية.

مرجع سهل القراءة: