حزم البيانات

انسخ قواعد الاختيار أو أنماط التسمية أو فحوص أسماء الإصدارات من تثبيت إلى آخر.

حزمة البيانات ملف JSON فيه بيانات فقط. لا تستطيع تشغيل كود، ولا جلب عنوان، ولا إضافة عمل، ولا تغيير مستخدم، ولا المساس بملفات الوسائط، ولا حمل أسرار.

قبل أن تبدأ

• أنت المالك.
• عندك مفتاح API بالنطاق admin. المفاتيح ذات النطاق health_read أو read أو write تُرفض.
• عندك ملف JSON للحزمة. استعمل الحزمة التي أُعطيت لك، أو اكتب واحدة وفق البنية المذكورة تحت للخبراء.

نقل حزمة

كل المسارات على http://your-server:6262.

1. أرسل الحزمة إلى POST /api/v1/data-packs/validate. يفحصها دون أن يحفظها. سترى "valid": true.
2. أرسل ملف JSON نفسه إلى POST /api/v1/data-packs. يحفظ الحزمة غير مفعّلة. لا يتغير شيء بعد.
3. افتح GET /api/v1/data-packs لسرد الحزم المحفوظة. و GET /api/v1/data-packs/{id} يصدّر واحدة منها.
4. افتح GET /api/v1/data-packs/{id}/preview مع pick_rule_id واحد لكل قاعدة و naming_id واحد على الأكثر. تحصل على approval_hash.
5. أرسل الاختيار نفسه مع الـ hash إلى POST /api/v1/data-packs/{id}/apply. سترى معرّف الحزمة ومعرّفات القواعد التي اخترتها.

المعاينة:

GET /api/v1/data-packs/home-cinema/preview?pick_rule_id=balanced-web&naming_id=readable

جسم طلب تطبيق الحزمة:

{
  "pick_rule_ids": ["balanced-web"],
  "naming_id": "readable",
  "approval_hash": "the hash returned by preview"
}

تنبيه

مجموعة التسمية تحل محل أنماط التسمية الحالية عندك. ولا تُعاد تسمية الملفات الموجودة.

ما الذي يغيّره تطبيق الحزمة

• كل قاعدة اختيار مختارة تُنشأ جديدة. ولا تُسند إلى أي عمل.
• مجموعة التسمية المختارة تحل محل هذه الإعدادات فقط:
  • أنماط ملف الفيلم ومجلده.
  • أنماط مجلد المسلسل، ومجلد الموسم، ومجلد الحلقات الخاصة، والحلقة، والحلقات اليومية، والأنمي.
  • أنماط مجلد الفنان، ومجلد الألبوم، ومجلد الأسطوانة، والمقطع، ومقطع الألبوم المتعدد الأسطوانات.
  • تنسيق النقطتين والأحرف غير المسموح بها.
  • أسلوب الحلقات المتعددة، وأسلوب تاريخ العرض، وعدد خانات الرقم المطلق.
• إعادة التسمية عند الاستيراد، وسلوك المجلدات، وقراءة الوسوم، وحدود الفحص لا تكون في الحزمة أبدًا.

إذا لم ينجح الأمر

العَرَض: تقول عملية تطبيق الحزمة إن المعاينة قديمة. السبب: تغيّرت بعد المعاينة الحزمة، أو اسم قاعدة اختيار كان سيتعارض، أو إعداد تسمية كانت ستحل محله. لم يُطبَّق شيء. الحل: أعد المعاينة وأرسل الـ hash الجديد.

العَرَض: يقول الاستيراد إن الحزمة موجودة من قبل. السبب: الحزم لا تُستبدل أبدًا. الحل: أعطِ الحزمة الجديدة معرّفًا آخر.

العَرَض: خطأ في الأذونات. السبب: المفتاح ليس مفتاح admin أنشأه المالك. الحل: أنشئ مفتاح admin وأنت المالك واستعمله.

للخبراء

الحدود وأسباب الرفض

الحد	القيمة
format	holyarrs-data-pack
version	1
حجم الحزمة أو التصدير	256 KiB
قواعد الاختيار	32
مجموعات التسمية	8
فحوص أسماء الإصدارات	256
المعرّفات	من 1 إلى 64 حرفًا: أحرف لاتينية صغيرة، وأرقام، ونقاط، وشرطات، وشرطات سفلية. تبدأ وتنتهي بحرف أو رقم
جسم طلب تطبيق الحزمة	16 KiB

تُرفض الحزمة بسبب حقول مكررة أو غير معروفة، أو JSON زائد بعد النهاية، أو أسماء جودة أو سمات غير معروفة، أو كلمات تسمية خاطئة، أو version غير 1، أو قيم تتجاوز هذه الحدود. ويمر كل فحص لاسم إصدار عبر محلّل HolyArrs ويجب أن يطابق كل معلومة يتوقعها.

بنية الحزمة

الحقل	ما يحتويه
format، version، id، name	الترويسة المطلوبة
pick_rules	لكل واحدة id و name و kinds و rules (الدرجات، والسمات، وحدود الحجم، والبروتوكول، واللغة، والترتيب)
naming	لكل واحدة id و name و patterns (إعدادات التسمية المذكورة أعلاه)
release_tests	لكل واحد id و name و release_name و hints و expected (النوع، والجودة، والدقة، والمصدر، و codec، والعلامات)

المسارات والردود

المسار	النجاح	الرفض
POST /api/v1/data-packs/validate	200 مع valid وملخص	400 غير صالحة، 413 أكبر من الحد
POST /api/v1/data-packs	201 مع ملخص، والحالة inactive	409 المعرّف موجود، 400، 413
GET /api/v1/data-packs	200 مع data_packs
GET /api/v1/data-packs/{id}	200 مع JSON الحزمة	404
GET /api/v1/data-packs/{id}/preview	200 مع approval_hash	400 لأي استعلام غير pick_rule_id و naming_id، 404
POST /api/v1/data-packs/{id}/apply	200 مع pack_id و pick_rule_ids و naming_id	409 قديمة، 400، 404

صفحات ذات صلة

• البيانات الوصفية
• المكتبة