Data pack-கள்

உங்கள் தேர்வு விதிகள், பெயரிடும் வடிவங்கள் அல்லது வெளியீட்டுப் பெயர் சோதனைகளை ஒரு நிறுவலிலிருந்து மற்றொன்றுக்கு நகலெடுக்கவும்.

Data pack என்பது தரவு மட்டுமே கொண்ட ஒரு JSON கோப்பு. அது நிரலை இயக்க முடியாது, முகவரியைப் பெற முடியாது, தலைப்பைச் சேர்க்க முடியாது, பயனரை மாற்ற முடியாது, media கோப்புகளைத் தொட முடியாது, ரகசியங்களையும் சுமக்க முடியாது.

தொடங்கும் முன்

• நீங்கள் உரிமையாளர்.
• உங்களிடம் admin scope கொண்ட ஒரு API விசை உள்ளது. health_read, read அல்லது write கொண்ட விசைகள் மறுக்கப்படும்.
• உங்களிடம் pack JSON உள்ளது. உங்களுக்குக் கொடுக்கப்பட்ட pack-ஐப் பயன்படுத்தவும், அல்லது நிபுணர்களுக்கு பகுதியில் உள்ள வடிவத்திலிருந்து ஒன்றை எழுதவும்.

ஒரு pack-ஐ நகர்த்துதல்

எல்லா routes-உம் http://your-server:6262-இல் உள்ளன.

1. Pack-ஐ POST /api/v1/data-packs/validate-க்கு அனுப்பவும். அது சேமிக்காமல் சோதிக்கிறது. "valid": true தெரிய வேண்டும்.
2. அதே JSON-ஐ POST /api/v1/data-packs-க்கு அனுப்பவும். அது pack-ஐ செயலற்றதாகச் சேமிக்கிறது. இன்னும் எதுவும் மாறாது.
3. சேமிக்கப்பட்ட pack-களைப் பட்டியலிட GET /api/v1/data-packs திறக்கவும். GET /api/v1/data-packs/{id} ஒன்றை ஏற்றுமதி செய்கிறது.
4. ஒவ்வொரு விதிக்கும் ஒரு pick_rule_id-உம், அதிகபட்சம் ஒரு naming_id-உம் கொடுத்து GET /api/v1/data-packs/{id}/preview திறக்கவும். உங்களுக்கு ஒரு approval_hash கிடைக்கும்.
5. அதே தேர்வையும் hash-ஐயும் POST /api/v1/data-packs/{id}/apply-க்கு அனுப்பவும். Pack id-உம் நீங்கள் தேர்ந்தெடுத்த விதி id-களும் தெரிய வேண்டும்.

Preview:

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

Apply body:

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

Caution

ஒரு பெயரிடும் தொகுப்பு உங்கள் தற்போதைய பெயரிடும் வடிவங்களை மாற்றிவிடும். ஏற்கெனவே உள்ள கோப்புகள் மறுபெயரிடப்படாது.

பயன்படுத்தினால் என்ன மாறும்

• நீங்கள் தேர்ந்தெடுத்த ஒவ்வொரு தேர்வு விதியும் புதிதாக உருவாக்கப்படும். அது எந்தத் தலைப்புக்கும் ஒதுக்கப்படாது.
• நீங்கள் தேர்ந்தெடுத்த பெயரிடும் தொகுப்பு இந்த அமைப்புகளை மட்டுமே மாற்றும்:
  • திரைப்படக் கோப்பு மற்றும் அடைவு வடிவங்கள்.
  • தொடர் அடைவு, பருவ அடைவு, சிறப்பு அத்தியாய அடைவு, அத்தியாயம், தினசரி மற்றும் anime வடிவங்கள்.
  • கலைஞர் அடைவு, ஆல்பம் அடைவு, வட்டு அடைவு, பாடல் மற்றும் பல வட்டுப் பாடல் வடிவங்கள்.
  • Colon மற்றும் செல்லாத எழுத்துகளின் வடிவமைப்பு.
  • பல அத்தியாயப் பாணி, ஒளிபரப்புத் தேதிப் பாணி, முழுமையான எண்ணின் இலக்கங்கள்.
• இறக்குமதியில் மறுபெயரிடுதல், அடைவு நடத்தை, tag படித்தல், scan வரம்புகள் ஆகியவை ஒருபோதும் ஒரு pack-இல் இருக்காது.

இது வேலை செய்யவில்லை என்றால்

அறிகுறி: முன்னோட்டம் பழையதாகிவிட்டது என்று Apply சொல்கிறது. காரணம்: முன்னோட்டத்துக்குப் பிறகு pack, மோதக்கூடிய ஒரு தேர்வு விதிப் பெயர், அல்லது அது மாற்றக்கூடிய ஒரு பெயரிடும் அமைப்பு மாறிவிட்டது. எதுவும் பயன்படுத்தப்படவில்லை. தீர்வு: மீண்டும் முன்னோட்டம் பார்க்கவும், புதிய hash-ஐ அனுப்பவும்.

அறிகுறி: Import, pack ஏற்கெனவே இருக்கிறது என்று சொல்கிறது. காரணம்: Pack-கள் ஒருபோதும் மாற்றப்படாது. தீர்வு: புதிய pack-க்கு வேறொரு id கொடுக்கவும்.

அறிகுறி: அனுமதிப் பிழை. காரணம்: அந்த விசை உரிமையாளர் உருவாக்கிய admin விசை அல்ல. தீர்வு: உரிமையாளராக ஒரு admin விசையை உருவாக்கிப் பயன்படுத்தவும்.

நிபுணர்களுக்கு

வரம்புகளும் மறுப்புகளும்

வரம்பு	மதிப்பு
format	holyarrs-data-pack
version	1
ஒரு pack அல்லது ஏற்றுமதியின் அளவு	256 KiB
தேர்வு விதிகள்	32
பெயரிடும் தொகுப்புகள்	8
வெளியீட்டுப் பெயர் சோதனைகள்	256
Id-கள்	1 முதல் 64 எழுத்துகள்: சிறிய எழுத்துகள், இலக்கங்கள், புள்ளிகள், கோடுகள், அடிக்கோடுகள். எழுத்து அல்லது இலக்கத்தில் தொடங்கி முடிய வேண்டும்
Apply request body	16 KiB

நகல் அல்லது தெரியாத புலங்கள், முடிவுக்குப் பிறகு கூடுதல் JSON, தெரியாத தரம் அல்லது பண்புப் பெயர்கள், தவறான பெயரிடும் சொற்கள், 1 அல்லாத பதிப்பு, அல்லது இந்த வரம்புகளைத் தாண்டிய மதிப்புகள் இருந்தால் pack மறுக்கப்படும். ஒவ்வொரு வெளியீட்டுப் பெயர் சோதனையும் HolyArrs parser வழியாக இயங்கி, அது எதிர்பார்க்கும் ஒவ்வொரு உண்மையுடனும் பொருந்த வேண்டும்.

Pack வடிவம்

புலம்	கொண்டிருப்பது
format, version, id, name	தேவையான header
pick_rules	ஒவ்வொன்றிலும் id, name, kinds, rules (படிகள், பண்புகள், அளவு வரம்புகள், protocol, மொழி, வரிசை) உள்ளன
naming	ஒவ்வொன்றிலும் id, name, patterns (மேலே பட்டியலிடப்பட்ட பெயரிடும் அமைப்புகள்) உள்ளன
release_tests	ஒவ்வொன்றிலும் id, name, release_name, hints, expected (வகை, தரம், resolution, மூலம், codec, flags) உள்ளன

Routes-உம் பதில்களும்

Route	வெற்றி	மறுப்பு
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, pack JSON-உடன்	404
GET /api/v1/data-packs/{id}/preview	200, approval_hash-உடன்	pick_rule_id, naming_id தவிர வேறு எந்த query-க்கும் 400, 404
POST /api/v1/data-packs/{id}/apply	200, pack_id, pick_rule_ids, naming_id-உடன்	409 பழையது, 400, 404

தொடர்புடையவை

• Metadata
• நூலகம்