Paket data

Salin aturan pilihan, pola penamaan, atau pemeriksaan nama rilis dari satu instalasi ke instalasi lain.

Paket data adalah file JSON yang hanya berisi data. Paket ini tidak bisa menjalankan kode, mengambil sebuah alamat, menambahkan judul, mengubah pengguna, menyentuh file media, atau membawa rahasia.

Sebelum mulai

• Kamu adalah pemilik.
• Kamu punya kunci API dengan scope admin. Kunci dengan health_read, read, atau write ditolak.
• Kamu punya JSON paketnya. Pakai paket yang diberikan kepada kamu, atau tulis sendiri dari bentuk yang ada di bawah Untuk yang mahir.

Pindahkan paket

Semua route ada di http://your-server:6262.

1. Kirim paket ke POST /api/v1/data-packs/validate. Route ini memeriksa tanpa menyimpan. Kamu akan melihat "valid": true.
2. Kirim JSON yang sama ke POST /api/v1/data-packs. Route ini menyimpan paket sebagai nonaktif. Belum ada yang berubah.
3. Buka GET /api/v1/data-packs untuk melihat daftar paket tersimpan. GET /api/v1/data-packs/{id} mengekspor satu paket.
4. Buka GET /api/v1/data-packs/{id}/preview dengan satu pick_rule_id per aturan dan paling banyak satu naming_id. Kamu akan mendapat approval_hash.
5. Kirim pilihan yang sama beserta hash-nya ke POST /api/v1/data-packs/{id}/apply. Kamu akan melihat id paket dan id aturan yang kamu pilih.

Preview:

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

Body apply:

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

Perhatian

Satu set penamaan menggantikan pola penamaan kamu yang sekarang. File yang sudah ada tidak diganti namanya.

Yang berubah saat diterapkan

• Setiap aturan pilihan yang dipilih dibuat baru. Aturan itu tidak dipasang ke judul mana pun.
• Satu set penamaan yang dipilih hanya menggantikan pengaturan berikut:
  • Pola file dan folder film.
  • Pola folder serial, folder musim, folder spesial, episode, harian, dan anime.
  • Pola folder artis, folder album, folder disc, lagu, dan lagu multi-disc.
  • Format titik dua dan karakter terlarang.
  • Gaya multi-episode, gaya tanggal tayang, dan jumlah digit nomor absolut.
• Ganti nama saat impor, perilaku folder, pembacaan tag, dan batas pemindaian tidak pernah ada di dalam paket.

Kalau tidak berhasil

Gejala: Apply bilang preview sudah kedaluwarsa. Penyebab: Paket, nama aturan pilihan yang akan bentrok, atau pengaturan penamaan yang akan digantikan berubah setelah preview. Tidak ada yang diterapkan. Solusi: Preview lagi lalu kirim hash yang baru.

Gejala: Impor bilang paket sudah ada. Penyebab: Paket tidak pernah ditimpa. Solusi: Beri paket baru id yang lain.

Gejala: Error izin. Penyebab: Kunci itu bukan kunci admin buatan pemilik. Solusi: Buat kunci admin sebagai pemilik dan pakai kunci itu.

Untuk yang mahir

Batas dan penolakan

Batas	Nilai
format	holyarrs-data-pack
version	1
Ukuran paket atau ekspor	256 KiB
Aturan pilihan	32
Set penamaan	8
Pemeriksaan nama rilis	256
Id	1 sampai 64 karakter: huruf kecil, angka, titik, tanda hubung, garis bawah. Dimulai dan diakhiri dengan huruf atau angka
Body permintaan apply	16 KiB

Paket ditolak kalau ada field ganda atau tidak dikenal, ada JSON tambahan setelah akhir, nama kualitas atau ciri tidak dikenal, kata penamaan yang salah, versi selain 1, atau nilai yang melewati batas-batas ini. Setiap pemeriksaan nama rilis dijalankan lewat parser HolyArrs dan harus cocok dengan setiap fakta yang diharapkannya.

Bentuk paket

Field	Isinya
format, version, id, name	Header wajib
pick_rules	Masing-masing punya id, name, kinds, dan rules (tahap, ciri, batas ukuran, protokol, bahasa, urutan)
naming	Masing-masing punya id, name, dan patterns (pengaturan penamaan yang tercantum di atas)
release_tests	Masing-masing punya id, name, release_name, hints, dan expected (jenis, kualitas, resolusi, sumber, codec, flag)

Route dan respons

Route	Berhasil	Penolakan
POST /api/v1/data-packs/validate	200 dengan valid dan ringkasan	400 tidak valid, 413 terlalu besar
POST /api/v1/data-packs	201 dengan ringkasan, status inactive	409 id sudah ada, 400, 413
GET /api/v1/data-packs	200 dengan data_packs
GET /api/v1/data-packs/{id}	200 dengan JSON paket	404
GET /api/v1/data-packs/{id}/preview	200 dengan approval_hash	400 untuk query selain pick_rule_id dan naming_id, 404
POST /api/v1/data-packs/{id}/apply	200 dengan pack_id, pick_rule_ids, naming_id	409 kedaluwarsa, 400, 404

Terkait

• Metadata
• Pustaka