API delle app precedenti

Collega a HolyArrs un’app che conosce solo Sonarr o Radarr. Dalle un indirizzo che finisce con /sonarr o /radarr e una chiave, e l’app tratta HolyArrs come quella app.

È una piccola API fatta solo per queste app. Per i tuoi script usa l’API di HolyArrs.

Attivarla

È disattivata per impostazione predefinita. Finché è disattivata, ogni indirizzo sotto /sonarr/ e /radarr/ risponde 404.

1. Apri Settings > API (Impostazioni > API).
2. Nella card Requests from Seerr and Overseerr (richieste da Seerr e Overseerr), attiva Answer Seerr and Overseerr (rispondi a Seerr e Overseerr).
3. Fai clic su Make key (crea chiave) accanto a Shows (serie). È la chiave lato Sonarr. Copiala subito: viene mostrata una volta sola.
4. Fai clic su Make key accanto a Movies (film). È la chiave lato Radarr. Copia anche questa.
5. Prendi nota dell’indirizzo di ogni lato sulla card, per esempio /sonarr. Con un URL base appare come /holyarrs/sonarr. Usa quello che mostra la card.

Per creare una chiave HolyArrs ti chiede di nuovo la password, se non hai fatto l’accesso con la password da poco. Poi configura ogni app: vedi Client dell’API delle app precedenti.

Attenzione

Seerr salva le chiavi in chiaro nel suo file delle impostazioni. Per questo Let these apps delete files (lascia che queste app eliminino i file) è disattivato per impostazione predefinita.

Impostazioni della card

Impostazione	Cosa fa	Predefinito
Answer Seerr and Overseerr	Attiva o disattiva insieme /sonarr e /radarr.	Disattivata
Make key / New key	Crea la chiave per quel lato. Una nuova chiave ferma subito la vecchia.
Remove key	Elimina la chiave di quel lato. Le app che la usano vengono rifiutate.
Let these apps delete files	Se è disattivata, rimuovere un titolo in un’app lascia i file. Se è attiva, i file vanno prima nella cartella di conservazione, come per ogni eliminazione in HolyArrs.	Disattivata

Per ogni chiave la card mostra gli ultimi 4 caratteri, chi l’ha creata e quando è stata usata l’ultima volta.

Per esperti

Inviare la chiave

HolyArrs legge la chiave dal primo posto in cui la trova, in quest’ordine. Una chiave sbagliata in un posto precedente fa fallire la richiesta, anche se una successiva è giusta.

Ordine	Posto	Esempio
1	valore di query apikey, maiuscole o minuscole	/sonarr/api/v3/series?apikey=KEY
2	header X-Api-Key	X-Api-Key: KEY
3	header Authorization, con o senza Bearer	Authorization: Bearer KEY

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

La forma con la query è accettata solo su questi indirizzi, e HolyArrs la nasconde nel proprio log. Un reverse proxy davanti potrebbe comunque registrare l’indirizzo completo.

Regole delle chiavi

• Ogni lato ha la sua chiave, creata solo su questa card. Le chiavi dell’API di HolyArrs (che iniziano con hak_) qui non funzionano, e queste chiavi non funzionano da nessun’altra parte.
• Una chiave agisce come la persona che l’ha creata, che deve avere il permesso di gestire la Libreria. Prowlarr richiede anche il permesso di modificare le impostazioni.
• Se quella persona viene disattivata o perde il permesso, le app vengono rifiutate finché qualcuno non crea una nuova chiave. La card ti avvisa.

Gestirla con l'API di HolyArrs

Devi aver fatto l’accesso con la tua password. Le chiamate sulle chiavi richiedono un accesso recente con la password.

Cosa	Chiamata
Leggere interruttori, indirizzi e chiavi	GET /api/v1/settings/old-app-api
Attivarla	PUT /api/v1/settings/old-app-api con {"enabled": true}
Lasciare che le app eliminino i file	PUT /api/v1/settings/old-app-api con {"delete_files": true}
Creare la chiave lato Sonarr	POST /api/v1/settings/old-app-api/keys/sonarr
Creare la chiave lato Radarr	POST /api/v1/settings/old-app-api/keys/radarr
Rimuovere una chiave	DELETE /api/v1/settings/old-app-api/keys/sonarr (o radarr)

Correlati

• Client dell’API delle app precedenti
• Limiti dell’API delle app precedenti
• Reverse proxy e URL base