بسته‌های داده

قوانین انتخاب، الگوهای نام‌گذاری یا بررسی‌های نام ریلیز خود را از یک نصب به نصب دیگر کپی کنید.

بستهٔ داده یک فایل 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. همان انتخاب و هش را به POST /api/v1/data-packs/{id}/apply بفرستید. باید شناسهٔ بسته و شناسهٔ قوانینی را که انتخاب کرده‌اید ببینید.

پیش‌نمایش:

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

بدنهٔ apply:

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

احتیاط

یک مجموعهٔ نام‌گذاری جای الگوهای نام‌گذاری فعلی شما را می‌گیرد. فایل‌های موجود تغییر نام نمی‌دهند.

اعمال بسته چه چیزی را تغییر می‌دهد

• هر قانون انتخابی که برگزیده‌اید تازه ساخته می‌شود. به هیچ عنوان کتابخانه‌ای اختصاص داده نمی‌شود.
• یک مجموعهٔ نام‌گذاری برگزیده فقط این تنظیم‌ها را جایگزین می‌کند:
  • الگوهای فایل و پوشهٔ فیلم.
  • الگوهای پوشهٔ سریال، پوشهٔ فصل، پوشهٔ ویژه‌ها، قسمت، روزانه و انیمه.
  • الگوهای پوشهٔ هنرمند، پوشهٔ آلبوم، پوشهٔ دیسک، آهنگ و آهنگ در چند دیسک.
  • قالب‌بندی دونقطه و نویسه‌های غیرمجاز.
  • سبک چندقسمتی، سبک تاریخ پخش و ارقام شمارهٔ مطلق.
• تغییر نام هنگام وارد کردن، رفتار پوشه، خواندن تگ و سقف‌های اسکن هرگز در یک بسته نیستند.

اگر کار نکرد

نشانه: Apply می‌گوید پیش‌نمایش کهنه است. علت: بعد از پیش‌نمایش، بسته، نام یک قانون انتخاب که تداخل پیدا می‌کرد، یا یک تنظیم نام‌گذاری که جایگزین می‌شد تغییر کرده است. چیزی اعمال نشد. راه‌حل: دوباره پیش‌نمایش بگیرید و هش جدید را بفرستید.

نشانه: Import می‌گوید بسته از قبل وجود دارد. علت: بسته‌ها هرگز جایگزین نمی‌شوند. راه‌حل: به بستهٔ جدید شناسهٔ دیگری بدهید.

نشانه: خطای دسترسی. علت: کلید یک کلید admin ساخته‌شده توسط مالک نیست. راه‌حل: به‌عنوان مالک یک کلید admin بسازید و از آن استفاده کنید.

برای حرفه‌ای‌ها

سقف‌ها و ردکردن‌ها

سقف	مقدار
format	holyarrs-data-pack
version	1
اندازهٔ یک بسته یا یک خروجی	256 KiB
قوانین انتخاب	32
مجموعه‌های نام‌گذاری	8
بررسی‌های نام ریلیز	256
شناسه‌ها	1 تا 64 نویسه: حروف کوچک، رقم، نقطه، خط تیره، زیرخط. با حرف یا رقم شروع و تمام می‌شوند
بدنهٔ درخواست apply	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 دارد (kind، quality، resolution، source، codec، flags)

مسیرها و پاسخ‌ها

مسیر	موفق	رد
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

صفحه‌های مرتبط

• فراداده
• کتابخانه