API de apps anteriores

Apunta a HolyArrs una app que solo conoce Sonarr o Radarr. Dale una dirección que termine en /sonarr o /radarr y una clave, y tratará a HolyArrs como esa app.

Es una API pequeña hecha solo para esas apps. Para tus propios scripts, usa la API de HolyArrs.

Activarla

Viene desactivada de forma predeterminada. Mientras lo esté, todas las direcciones bajo /sonarr/ y /radarr/ responden 404.

1. Abre Settings > API (Ajustes > API).
2. En la tarjeta Requests from Seerr and Overseerr (solicitudes de Seerr y Overseerr), activa Answer Seerr and Overseerr (responder a Seerr y Overseerr).
3. Haz clic en Make key (crear clave) junto a Shows (series). Esta es la clave del lado Sonarr. Cópiala ahora; se muestra una sola vez.
4. Haz clic en Make key junto a Movies (películas). Esta es la clave del lado Radarr. Cópiala también.
5. Anota la dirección de cada lado que aparece en la tarjeta, por ejemplo /sonarr. Con una URL base muestra /holyarrs/sonarr. Usa lo que muestre la tarjeta.

Al crear una clave se te vuelve a pedir la contraseña si no has iniciado sesión con ella hace poco. Después configura cada app: consulta Clientes de la API de apps anteriores.

Precaución

Seerr guarda las claves en texto sin cifrar en su archivo de ajustes. Por eso Let these apps delete files (permitir que estas apps borren archivos) viene desactivado de forma predeterminada.

Ajustes de la tarjeta

Ajuste	Qué hace	Predeterminado
Answer Seerr and Overseerr	Activa o desactiva /sonarr y /radarr a la vez.	Desactivado
Make key / New key (clave nueva)	Crea la clave de ese lado. Una clave nueva anula la anterior al instante.
Remove key (quitar clave)	Borra la clave de ese lado. Las apps que la usan son rechazadas.
Let these apps delete files	Desactivado: quitar un título en una app deja los archivos. Activado: los archivos van primero a la carpeta de retención, como en todos los borrados de HolyArrs.	Desactivado

Para cada clave, la tarjeta muestra sus últimos 4 caracteres, quién la creó y cuándo se usó por última vez.

Para expertos

Enviar la clave

HolyArrs lee la clave del primer lugar donde la encuentra, en este orden. Una clave incorrecta en un lugar anterior falla, aunque la de un lugar posterior sea correcta.

Orden	Lugar	Ejemplo
1	Valor apikey en la consulta, con mayúsculas o minúsculas	/sonarr/api/v3/series?apikey=KEY
2	Cabecera X-Api-Key	X-Api-Key: KEY
3	Cabecera Authorization, con o sin Bearer	Authorization: Bearer KEY

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

La forma por consulta solo se acepta en estas direcciones, y HolyArrs la oculta en su propio registro (log). Un proxy inverso delante puede registrar igualmente la dirección completa.

Reglas de las claves

• Cada lado tiene su propia clave, que solo se crea en esta tarjeta. Las claves de API de HolyArrs (las que empiezan por hak_) no funcionan aquí, y estas claves no funcionan en ningún otro lugar.
• Una clave actúa como la persona que la creó, que necesita permiso para gestionar la Biblioteca. Prowlarr también necesita permiso para cambiar ajustes.
• Si esa persona es desactivada o pierde el permiso, las apps son rechazadas hasta que alguien cree una clave nueva. La tarjeta te lo advierte.

Gestionarla con la API de HolyArrs

Con la sesión iniciada con tu contraseña. Las llamadas de claves necesitan un inicio de sesión reciente con contraseña.

Qué	Llamada
Leer interruptores, direcciones y claves	GET /api/v1/settings/old-app-api
Activarla	PUT /api/v1/settings/old-app-api con {"enabled": true}
Permitir que las apps borren archivos	PUT /api/v1/settings/old-app-api con {"delete_files": true}
Crear la clave del lado Sonarr	POST /api/v1/settings/old-app-api/keys/sonarr
Crear la clave del lado Radarr	POST /api/v1/settings/old-app-api/keys/radarr
Quitar una clave	DELETE /api/v1/settings/old-app-api/keys/sonarr (o radarr)

Relacionado

• Clientes de la API de apps anteriores
• Límites de la API de apps anteriores
• Proxy inverso y URL base