Veri paketleri

Seçim kurallarını, adlandırma kalıplarını ya da sürüm adı kontrollerini bir kurulumdan diğerine kopyala.

Veri paketi yalnızca veri içeren bir JSON dosyasıdır. Kod çalıştıramaz, bir adres getiremez, başlık ekleyemez, kullanıcıyı değiştiremez, medya dosyalarına dokunamaz ve gizli bilgi taşıyamaz.

Başlamadan önce

• Sahipsin.
• admin kapsamlı bir API anahtarın var. health_read, read veya write kapsamlı anahtarlar reddedilir.
• Paketin JSON’u elinde. Sana verilen paketi kullan ya da Uzmanlar için altındaki şekle göre kendin yaz.

Bir paketi taşı

Tüm rotalar http://your-server:6262 üzerindedir.

1. Paketi POST /api/v1/data-packs/validate rotasına gönder. Kaydetmeden kontrol eder. "valid": true görmelisin.
2. Aynı JSON’u POST /api/v1/data-packs rotasına gönder. Paketi etkin olmayan olarak kaydeder. Henüz hiçbir şey değişmez.
3. Kayıtlı paketleri listelemek için GET /api/v1/data-packs rotasını aç. GET /api/v1/data-packs/{id} birini dışa aktarır.
4. GET /api/v1/data-packs/{id}/preview rotasını, her kural için bir pick_rule_id ve en fazla bir naming_id ile aç. Bir approval_hash alırsın.
5. Aynı seçimi ve hash’i POST /api/v1/data-packs/{id}/apply rotasına gönder. Paket kimliğini ve seçtiğin kural kimliklerini görmelisin.

Önizleme:

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

Uygulama gövdesi:

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

Dikkat

Bir adlandırma seti mevcut adlandırma kalıplarının yerine geçer. Var olan dosyalar yeniden adlandırılmaz.

Uygulamak neyi değiştirir

• Seçtiğin her Seçim kuralı yeni oluşturulur. Hiçbir başlığa atanmaz.
• Seçtiğin adlandırma seti yalnızca şu ayarların yerine geçer:
  • Film dosyası ve klasörü kalıpları.
  • Dizi klasörü, sezon klasörü, özel bölümler klasörü, bölüm, günlük ve anime kalıpları.
  • Sanatçı klasörü, albüm klasörü, disk klasörü, parça ve çok diskli parça kalıpları.
  • İki nokta ve geçersiz karakter biçimlendirmesi.
  • Çok bölümlü stil, yayın tarihi stili ve mutlak numara basamakları.
• İçe aktarmada yeniden adlandırma, klasör davranışı, etiket okuma ve tarama sınırları hiçbir zaman pakette olmaz.

Çalışmazsa

Belirti: Uygulama, önizlemenin eskidiğini söylüyor. Neden: Önizlemeden sonra paket, çakışacak bir Seçim kuralı adı ya da yerine geçeceği bir adlandırma ayarı değişti. Hiçbir şey uygulanmadı. Çözüm: Yeniden önizle ve yeni hash’i gönder.

Belirti: İçe aktarma, paketin zaten var olduğunu söylüyor. Neden: Var olan paketlerin üzerine hiçbir zaman yazılmaz. Çözüm: Yeni pakete başka bir kimlik ver.

Belirti: İzin hatası. Neden: Anahtar, sahibin oluşturduğu bir admin anahtarı değil. Çözüm: Sahip olarak bir admin anahtarı oluştur ve onu kullan.

Uzmanlar için

Sınırlar ve ret nedenleri

Sınır	Değer
format	holyarrs-data-pack
version	1
Bir paketin ya da dışa aktarmanın boyutu	256 KiB
Seçim kuralları	32
Adlandırma setleri	8
Sürüm adı kontrolleri	256
Kimlikler	1 ile 64 karakter: küçük harfler, rakamlar, nokta, tire, alt çizgi. Harf ya da rakamla başlar ve biter
Uygulama isteği gövdesi	16 KiB

Bir paket şu durumlarda reddedilir: tekrar eden ya da bilinmeyen alanlar, JSON bittikten sonra fazladan içerik, bilinmeyen kalite ya da özellik adları, geçersiz adlandırma kelimeleri, 1 dışında bir sürüm numarası ya da bu sınırları aşan değerler. Her sürüm adı kontrolü HolyArrs ayrıştırıcısından geçer ve beklediği her bilgiyle eşleşmelidir.

Paketin şekli

Alan	İçerik
format, version, id, name	Zorunlu başlık
pick_rules	Her birinde id, name, kinds ve rules var (adımlar, özellikler, boyut sınırları, protokol, dil, sıra)
naming	Her birinde id, name ve patterns var (yukarıda listelenen adlandırma ayarları)
release_tests	Her birinde id, name, release_name, hints ve expected var (tür, kalite, çözünürlük, kaynak, codec, bayraklar)

Rotalar ve yanıtlar

Rota	Başarı	Ret
POST /api/v1/data-packs/validate	valid ve bir özetle 200	400 geçersiz, 413 çok büyük
POST /api/v1/data-packs	Özetle 201, durum inactive	409 kimlik var, 400, 413
GET /api/v1/data-packs	data_packs ile 200
GET /api/v1/data-packs/{id}	Paket JSON’uyla 200	404
GET /api/v1/data-packs/{id}/preview	approval_hash ile 200	pick_rule_id ve naming_id dışındaki her sorgu için 400, 404
POST /api/v1/data-packs/{id}/apply	pack_id, pick_rule_ids, naming_id ile 200	409 eski, 400, 404

İlgili

• Metadata
• Kütüphane