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

يمتلك كل مشروع إعدادات نشطة — مثل القصّ (trim) والخلفية ونمط الترجمة والتخطيط — تتحكم في كيفية إخراج التصديرات. استخدم إعدادات المشروع عندما تريد تجاوزات محلية خاصة بالمشروع لا تستحق مشاركتها كقالب مسبق (preset). راجع Render settings reference للاطّلاع على خريطة الحقول المشتركة:
preset, settings.style, و settingsOverride.

نقاط النهاية

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

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

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

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

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

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

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

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

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 بتصدير المخطط (schema) الذي يتحقق من صحة تحديثات إعدادات المشروع. حوّله إلى JSON Schema أثناء التشغيل:

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

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();

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

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