Pakej data

Salin Peraturan pilihan, corak penamaan atau semakan nama keluaran anda dari satu pemasangan ke yang lain.

Pakej data ialah fail JSON yang hanya mengandungi data. Ia tidak boleh menjalankan kod, mengambil alamat, menambah judul, mengubah pengguna, menyentuh fail media atau membawa rahsia.

Sebelum bermula

• Anda ialah pemilik.
• Anda ada kunci API dengan skop admin. Kunci dengan health_read, read atau write ditolak.
• Anda ada JSON pakej. Gunakan pakej yang diberikan kepada anda, atau tulis satu daripada bentuk di bawah Untuk pakar.

Pindahkan pakej

Semua laluan berada pada http://your-server:6262.

1. Hantar pakej ke POST /api/v1/data-packs/validate. Ia menyemak tanpa menyimpan. Anda akan nampak "valid": true.
2. Hantar JSON yang sama ke POST /api/v1/data-packs. Ia menyimpan pakej sebagai tidak aktif. Belum ada apa yang berubah.
3. Buka GET /api/v1/data-packs untuk menyenaraikan pakej yang disimpan. GET /api/v1/data-packs/{id} mengeksport satu pakej.
4. Buka GET /api/v1/data-packs/{id}/preview dengan satu pick_rule_id bagi setiap peraturan dan paling banyak satu naming_id. Anda mendapat approval_hash.
5. Hantar pilihan yang sama dan hash itu ke POST /api/v1/data-packs/{id}/apply. Anda akan nampak id pakej dan id peraturan yang anda pilih.

Pratonton:

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

Isi apply:

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

Caution

Set penamaan menggantikan corak penamaan semasa anda. Fail sedia ada tidak dinamakan semula.

Apa yang berubah apabila pakej dilaksanakan

• Setiap Peraturan pilihan yang dipilih dicipta baharu. Ia tidak diberikan kepada mana-mana judul.
• Set penamaan yang dipilih hanya menggantikan tetapan ini:
  • Corak fail dan folder filem.
  • Corak folder siri, folder musim, folder episod khas, episod, harian dan anime.
  • Corak folder artis, folder album, folder cakera, lagu dan lagu berbilang cakera.
  • Pemformatan titik bertindih dan aksara tidak sah.
  • Gaya berbilang episod, gaya tarikh siaran dan digit nombor mutlak.
• Namakan semula semasa import, tingkah laku folder, pembacaan teg dan had imbasan tidak pernah ada dalam pakej.

Jika tidak berfungsi

Gejala: Apply menyatakan pratonton sudah lapuk. Punca: Pakej, nama Peraturan pilihan yang akan bertembung, atau tetapan penamaan yang akan digantikan telah berubah selepas pratonton. Tiada apa yang dilaksanakan. Penyelesaian: Pratonton semula dan hantar hash yang baharu.

Gejala: Import menyatakan pakej sudah wujud. Punca: Pakej tidak pernah diganti. Penyelesaian: Beri pakej baharu id yang lain.

Gejala: Ralat kebenaran. Punca: Kunci itu bukan kunci admin yang dibuat oleh pemilik. Penyelesaian: Cipta kunci admin sebagai pemilik dan gunakannya.

Untuk pakar

Had dan penolakan

Had	Nilai
format	holyarrs-data-pack
version	1
Saiz pakej atau eksport	256 KiB
Peraturan pilihan	32
Set penamaan	8
Semakan nama keluaran	256
Id	1 hingga 64 aksara: huruf kecil, digit, titik, sengkang, garis bawah. Bermula dan berakhir dengan huruf atau digit
Isi permintaan apply	16 KiB

Pakej ditolak jika ada medan berganda atau tidak dikenali, JSON tambahan selepas penghujung, nama kualiti atau ciri yang tidak dikenali, perkataan penamaan yang salah, versi selain 1, atau nilai melebihi had ini. Setiap semakan nama keluaran dijalankan melalui penghurai HolyArrs dan mesti sepadan dengan setiap fakta yang dijangkakan.

Bentuk pakej

Medan	Mengandungi
format, version, id, name	Pengepala wajib
pick_rules	Setiap satu ada id, name, kinds dan rules (peringkat, ciri, had saiz, protokol, bahasa, susunan)
naming	Setiap satu ada id, name dan patterns (tetapan penamaan yang disenaraikan di atas)
release_tests	Setiap satu ada id, name, release_name, hints dan expected (jenis, kualiti, resolusi, sumber, codec, bendera)

Laluan dan respons

Laluan	Berjaya	Penolakan
POST /api/v1/data-packs/validate	200 dengan valid dan ringkasan	400 tidak sah, 413 terlalu besar
POST /api/v1/data-packs	201 dengan ringkasan, status inactive	409 id sudah wujud, 400, 413
GET /api/v1/data-packs	200 dengan data_packs
GET /api/v1/data-packs/{id}	200 dengan JSON pakej	404
GET /api/v1/data-packs/{id}/preview	200 dengan approval_hash	400 untuk sebarang pertanyaan 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 lapuk, 400, 404

Berkaitan

• Metadata
• Pustaka