डेटा पैक

अपने चुनाव के नियम, नाम रखने के पैटर्न या रिलीज़ के नाम की जाँचें एक इंस्टॉल से दूसरे में कॉपी करें।

डेटा पैक एक JSON फ़ाइल है जिसमें सिर्फ़ डेटा होता है। वह कोड नहीं चला सकता, कोई एड्रेस नहीं खोल सकता, टाइटल नहीं जोड़ सकता, यूज़र नहीं बदल सकता, मीडिया फ़ाइलों को नहीं छू सकता और उसमें गोपनीय चीज़ें नहीं रखी जा सकतीं।

शुरू करने से पहले

• आप ओनर हैं।
• आपके पास admin स्कोप वाली API कुंजी है। 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 पर भेजें। पैक की id और आपके चुने हुए नियमों की id दिखनी चाहिए।

प्रीव्यू:

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"
}

सावधानी

नाम रखने का सेट आपके मौजूदा नाम रखने के पैटर्न की जगह ले लेता है। मौजूदा फ़ाइलों के नाम नहीं बदले जाते।

लागू करने से क्या बदलता है

• चुना हुआ हर चुनाव का नियम नया बनाया जाता है। वह किसी टाइटल को नहीं दिया जाता।
• चुना हुआ नाम रखने का सेट सिर्फ़ इन सेटिंग की जगह लेता है:
  • फ़िल्म की फ़ाइल और फ़ोल्डर के पैटर्न।
  • शो फ़ोल्डर, सीज़न फ़ोल्डर, स्पेशल एपिसोड फ़ोल्डर, एपिसोड, रोज़ाना और ऐनिमे के पैटर्न।
  • कलाकार फ़ोल्डर, एल्बम फ़ोल्डर, डिस्क फ़ोल्डर, ट्रैक और कई डिस्क वाले ट्रैक के पैटर्न।
  • कोलन और अमान्य अक्षरों की फ़ॉर्मैटिंग।
  • कई एपिसोड का स्टाइल, प्रसारण की तारीख़ का स्टाइल और एब्सोल्यूट नंबर के अंक।
• इंपोर्ट पर नाम बदलना, फ़ोल्डर का बर्ताव, टैग पढ़ना और स्कैन की सीमाएं कभी पैक में नहीं होतीं।

अगर काम न करे

लक्षण: लागू करते समय संदेश आता है कि प्रीव्यू पुराना पड़ गया है। वजह: प्रीव्यू के बाद पैक बदल गया, या किसी चुनाव के नियम का वह नाम जो टकराएगा, या नाम रखने की वह सेटिंग जिसकी जगह यह लेगा। कुछ भी लागू नहीं हुआ। हल: दोबारा प्रीव्यू करें और नया हैश भेजें।

लक्षण: इंपोर्ट कहता है कि पैक पहले से मौजूद है। वजह: पैक की जगह कभी दूसरा पैक नहीं रखा जाता। हल: नए पैक को कोई दूसरी id दें।

लक्षण: अनुमति का एरर। वजह: कुंजी ओनर की बनाई हुई admin कुंजी नहीं है। हल: ओनर के तौर पर एक admin कुंजी बनाएं और उसे इस्तेमाल करें।

एक्सपर्ट के लिए

सीमाएं और मना करने की वजहें

सीमा	वैल्यू
format	holyarrs-data-pack
version	1
पैक या एक्सपोर्ट का साइज़	256 KiB
चुनाव के नियम	32
नाम रखने के सेट	8
रिलीज़ के नाम की जाँचें	256
Id	1 से 64 अक्षर: छोटे अंग्रेज़ी अक्षर, अंक, डॉट, डैश, अंडरस्कोर। शुरू और आख़िर में अक्षर या अंक
लागू करने की रिक्वेस्ट बॉडी	16 KiB

पैक इन वजहों से मना कर दिया जाता है: दोहराए गए या अनजान फ़ील्ड, आख़िर के बाद फ़ालतू JSON, क्वालिटी या विशेषता के अनजान नाम, नाम रखने के ग़लत शब्द, 1 के अलावा कोई वर्ज़न, या इन सीमाओं से बाहर की वैल्यू। रिलीज़ के नाम की हर जाँच HolyArrs के पार्सर से गुज़रती है और उसे हर उस बात से मेल खाना चाहिए जिसकी वह उम्मीद करती है।

पैक का ढाँचा

फ़ील्ड	इसमें क्या होता है
format, version, id, name	ज़रूरी हेडर
pick_rules	हर एक में id, name, kinds और rules (पायदान, विशेषताएं, साइज़ की सीमाएं, प्रोटोकॉल, भाषा, क्रम)
naming	हर एक में id, name और patterns (ऊपर बताई गई नाम रखने की सेटिंग)
release_tests	हर एक में id, name, release_name, hints और expected (किस्म, क्वालिटी, रेज़ोल्यूशन, सोर्स, कोडेक, फ़्लैग)

रूट और जवाब

रूट	सफल होने पर	मना होने पर
POST /api/v1/data-packs/validate	200, valid और एक सार के साथ	400 अमान्य, 413 बहुत बड़ा
POST /api/v1/data-packs	201, एक सार के साथ, स्टेटस inactive	409 id पहले से है, 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 के साथ	pick_rule_id और naming_id के अलावा किसी भी क्वेरी पर 400, 404
POST /api/v1/data-packs/{id}/apply	200, pack_id, pick_rule_ids, naming_id के साथ	409 पुराना पड़ गया, 400, 404

इससे जुड़े पेज

• मेटाडेटा
• लाइब्रेरी