API aplikasi lama

Arahkan aplikasi yang hanya mengenal Sonarr atau Radarr ke HolyArrs. Beri alamat yang berakhiran /sonarr atau /radarr dan sebuah kunci, lalu aplikasi itu menganggap HolyArrs sebagai Sonarr atau Radarr.

Ini API kecil yang dibuat khusus untuk aplikasi-aplikasi itu. Untuk skrip kamu sendiri, pakai API HolyArrs.

Aktifkan

Fitur ini nonaktif secara bawaan. Selama nonaktif, setiap alamat di bawah /sonarr/ dan /radarr/ dijawab 404.

1. Buka Settings > API (pengaturan > API).
2. Di kartu Requests from Seerr and Overseerr (permintaan dari Seerr dan Overseerr), aktifkan Answer Seerr and Overseerr (jawab Seerr dan Overseerr).
3. Klik Make key (buat kunci) di samping Shows (serial). Ini kunci sisi Sonarr. Salin sekarang; kunci hanya ditampilkan sekali.
4. Klik Make key di samping Movies (film). Ini kunci sisi Radarr. Salin juga.
5. Catat alamat untuk setiap sisi di kartu, misalnya /sonarr. Kalau memakai URL base, tampilannya /holyarrs/sonarr. Pakai yang tertulis di kartu.

Membuat kunci meminta kata sandi kamu lagi kalau kamu belum login dengan kata sandi itu belakangan ini. Setelah itu siapkan setiap aplikasi: lihat Klien API aplikasi lama.

Perhatian

Seerr menyimpan kunci sebagai teks biasa di file pengaturannya. Itu sebabnya Let these apps delete files nonaktif secara bawaan.

Pengaturan kartu

Pengaturan	Fungsinya	Bawaan
Answer Seerr and Overseerr	Mengaktifkan atau menonaktifkan /sonarr dan /radarr sekaligus.	Nonaktif
Make key / New key	Membuat kunci untuk sisi itu. Kunci baru langsung menghentikan kunci yang lama.
Remove key	Menghapus kunci sisi itu. Aplikasi yang memakainya ditolak.
Let these apps delete files	Kalau nonaktif, menghapus judul di sebuah aplikasi membiarkan file-nya. Kalau aktif, file masuk dulu ke folder penampungan, seperti setiap penghapusan di HolyArrs.	Nonaktif

Untuk setiap kunci, kartu menampilkan 4 karakter terakhirnya, siapa yang membuatnya dan kapan terakhir dipakai.

Untuk yang mahir

Mengirim kunci

HolyArrs membaca kunci dari tempat pertama yang ditemukan, dengan urutan ini. Kunci yang salah di tempat yang lebih awal akan gagal, walaupun yang di tempat berikutnya benar.

Urutan	Tempat	Contoh
1	Nilai query apikey, huruf besar atau kecil	/sonarr/api/v3/series?apikey=KEY
2	Header X-Api-Key	X-Api-Key: KEY
3	Header Authorization, dengan atau tanpa Bearer	Authorization: Bearer KEY

curl -H "X-Api-Key: KEY" http://your-server:6262/sonarr/api/v3/system/status

Bentuk query hanya diterima di alamat-alamat ini, dan HolyArrs menyembunyikannya di lognya sendiri. Reverse proxy di depannya mungkin tetap mencatat alamat lengkapnya.

Aturan kunci

• Setiap sisi punya kunci sendiri, yang dibuat hanya di kartu ini. Kunci API HolyArrs (yang diawali hak_) tidak berfungsi di sini, dan kunci-kunci ini tidak berfungsi di tempat lain.
• Kunci bertindak sebagai orang yang membuatnya, yang harus punya izin untuk mengelola pustaka. Prowlarr juga butuh izin untuk mengubah pengaturan.
• Kalau orang itu dinonaktifkan atau kehilangan izinnya, aplikasi ditolak sampai seseorang membuat kunci baru. Kartu memberi peringatan.

Kelola dengan API HolyArrs

Kamu harus masuk dengan kata sandi. Panggilan untuk kunci butuh login dengan kata sandi yang dilakukan belum lama ini.

Yang dilakukan	Panggilan
Membaca sakelar, alamat dan kunci	GET /api/v1/settings/old-app-api
Mengaktifkan	PUT /api/v1/settings/old-app-api dengan {"enabled": true}
Mengizinkan aplikasi menghapus file	PUT /api/v1/settings/old-app-api dengan {"delete_files": true}
Membuat kunci sisi Sonarr	POST /api/v1/settings/old-app-api/keys/sonarr
Membuat kunci sisi Radarr	POST /api/v1/settings/old-app-api/keys/radarr
Menghapus sebuah kunci	DELETE /api/v1/settings/old-app-api/keys/sonarr (atau radarr)

Terkait

• Klien API aplikasi lama
• Batasan API aplikasi lama
• Reverse proxy dan URL base