API til tidligere apps

Peg en app, der kun kender Sonarr eller Radarr, mod HolyArrs. Giv den en adresse, der ender på /sonarr eller /radarr, og en nøgle, så behandler den HolyArrs som den app.

Det er et lille API, der kun er lavet til de apps. Til dine egne scripts skal du bruge HolyArrs API.

Slå det til

Det er slået fra som standard. Imens svarer hver adresse under /sonarr/ og /radarr/ 404.

1. Åbn Settings > API (indstillinger > API).
2. På kortet Requests from Seerr and Overseerr (ønsker fra Seerr og Overseerr) skal du slå Answer Seerr and Overseerr (svar Seerr og Overseerr) til.
3. Klik på Make key (lav nøgle) ud for Shows (serier). Det er nøglen til Sonarr-siden. Kopiér den nu; den vises kun én gang.
4. Klik på Make key ud for Movies (film). Det er nøglen til Radarr-siden. Kopiér den også.
5. Notér adressen for hver side på kortet, for eksempel /sonarr. Under en URL base vises /holyarrs/sonarr. Brug det, kortet viser.

Når du laver en nøgle, bliver du bedt om din adgangskode igen, hvis du ikke har logget ind med den for nylig. Derefter sætter du hver app op: se Klienter til API’et til tidligere apps.

Bemærk

Seerr gemmer nøgler i klartekst i sin indstillingsfil. Derfor er Let these apps delete files (lad disse apps slette filer) slået fra som standard.

Indstillinger på kortet

Indstilling	Hvad den gør	Standard
Answer Seerr and Overseerr	Slår /sonarr og /radarr til eller fra sammen.	Fra
Make key / New key (ny nøgle)	Laver nøglen til den side. En ny nøgle stopper den gamle med det samme.
Remove key (fjern nøgle)	Sletter den sides nøgle. Apps, der bruger den, afvises.
Let these apps delete files	Når den er fra, efterlader fjernelse af en titel i en app filerne. Når den er til, går filerne først til opbevaringsmappen, som ved hver anden sletning i HolyArrs.	Fra

For hver nøgle viser kortet de sidste 4 tegn, hvem der lavede den, og hvornår den sidst blev brugt.

For erfarne

Send nøglen

HolyArrs læser nøglen det første sted, den finder den, i denne rækkefølge. En forkert nøgle et tidligere sted fejler, selv om en senere er rigtig.

Rækkefølge	Sted	Eksempel
1	apikey-værdi i forespørgslen, uanset store og små bogstaver	/sonarr/api/v3/series?apikey=KEY
2	X-Api-Key-header	X-Api-Key: KEY
3	Authorization-header, med eller uden Bearer	Authorization: Bearer KEY

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

Formen med forespørgslen accepteres kun på disse adresser, og HolyArrs skjuler den i sin egen log. En reverse proxy foran kan stadig logge hele adressen.

Regler for nøgler

• Hver side har sin egen nøgle, som kun laves på dette kort. HolyArrs’ API-nøgler (der starter med hak_) virker ikke her, og disse nøgler virker ingen andre steder.
• En nøgle handler som den person, der lavede den, og personen skal have rettighed til at styre biblioteket. Prowlarr skal også have rettighed til at ændre indstillinger.
• Hvis personen bliver slået fra eller mister rettigheden, afvises apps, indtil nogen laver en ny nøgle. Kortet advarer dig.

Styr det med HolyArrs API

Logget ind med din adgangskode. Kald til nøgler kræver et nyligt login med adgangskode.

Hvad	Kald
Læs kontakter, adresser og nøgler	GET /api/v1/settings/old-app-api
Slå det til	PUT /api/v1/settings/old-app-api med {"enabled": true}
Lad apps slette filer	PUT /api/v1/settings/old-app-api med {"delete_files": true}
Lav nøglen til Sonarr-siden	POST /api/v1/settings/old-app-api/keys/sonarr
Lav nøglen til Radarr-siden	POST /api/v1/settings/old-app-api/keys/radarr
Fjern en nøgle	DELETE /api/v1/settings/old-app-api/keys/sonarr (eller radarr)

Se også

• Klienter til API’et til tidligere apps
• Grænser for API’et til tidligere apps
• Reverse proxy og URL base