API παλαιότερων εφαρμογών

Για έμπειρους

Σύνδεσε με το HolyArrs μια εφαρμογή που ξέρει μόνο Sonarr ή Radarr. Δώσε της μια διεύθυνση που τελειώνει σε /sonarr ή /radarr και ένα κλειδί, και θα το αντιμετωπίσει σαν εκείνη την εφαρμογή.

Είναι ένα μικρό API φτιαγμένο μόνο για αυτές τις εφαρμογές. Για τα δικά σου scripts χρησιμοποίησε το API του HolyArrs.

Ενεργοποίησέ το

Είναι απενεργοποιημένο από προεπιλογή. Όσο είναι απενεργοποιημένο, κάθε διεύθυνση κάτω από /sonarr/ και /radarr/ απαντά 404.

Άνοιξε Settings > API (Ρυθμίσεις > API).
Στην κάρτα Requests from Seerr and Overseerr (αιτήματα από Seerr και Overseerr), ενεργοποίησε το Answer Seerr and Overseerr (απάντηση σε Seerr και Overseerr).
Πάτησε Make key (δημιουργία κλειδιού) δίπλα στο Shows (σειρές). Αυτό είναι το κλειδί της πλευράς Sonarr. Αντίγραψέ το τώρα· εμφανίζεται μία φορά.
Πάτησε Make key δίπλα στο Movies (ταινίες). Αυτό είναι το κλειδί της πλευράς Radarr. Αντίγραψε και αυτό.
Σημείωσε τη διεύθυνση κάθε πλευράς στην κάρτα, όπως /sonarr. Κάτω από URL base εμφανίζεται ως /holyarrs/sonarr. Χρησιμοποίησε ό,τι δείχνει η κάρτα.

Η δημιουργία κλειδιού ζητά ξανά τον κωδικό πρόσβασής σου, αν δεν έχεις συνδεθεί με αυτόν πρόσφατα. Μετά ρύθμισε κάθε εφαρμογή: δες τους Πελάτες του API παλαιότερων εφαρμογών.

Ρυθμίσεις της κάρτας

Ρύθμιση	Τι κάνει	Προεπιλογή
Answer Seerr and Overseerr	Ενεργοποιεί ή απενεργοποιεί μαζί τα `/sonarr` και `/radarr`.	Απενεργοποιημένο
Make key / New key (νέο κλειδί)	Φτιάχνει το κλειδί για εκείνη την πλευρά. Ένα νέο κλειδί σταματά αμέσως το παλιό.
Remove key (αφαίρεση κλειδιού)	Διαγράφει το κλειδί της πλευράς. Οι εφαρμογές που το χρησιμοποιούν απορρίπτονται.
Let these apps delete files	Όταν είναι απενεργοποιημένο, η αφαίρεση ενός τίτλου σε μια εφαρμογή αφήνει τα αρχεία. Όταν είναι ενεργοποιημένο, τα αρχεία πηγαίνουν πρώτα στον φάκελο αναμονής, όπως σε κάθε διαγραφή του HolyArrs.	Απενεργοποιημένο

Για κάθε κλειδί η κάρτα δείχνει τους 4 τελευταίους χαρακτήρες, ποιος το έφτιαξε και πότε χρησιμοποιήθηκε τελευταία φορά.

Για έμπειρους

Αποστολή του κλειδιού

Το HolyArrs διαβάζει το κλειδί από το πρώτο σημείο που θα βρει, με αυτή τη σειρά. Ένα λάθος κλειδί σε προηγούμενο σημείο αποτυγχάνει, ακόμα κι αν κάποιο επόμενο είναι σωστό.

Σειρά	Σημείο	Παράδειγμα
1	τιμή `apikey` στο query, με κεφαλαία ή μικρά γράμματα	`/sonarr/api/v3/series?apikey=KEY`
2	κεφαλίδα `X-Api-Key`	`X-Api-Key: KEY`
3	κεφαλίδα `Authorization`, με ή χωρίς `Bearer`	`Authorization: Bearer KEY`

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

Η μορφή με query γίνεται δεκτή μόνο σε αυτές τις διευθύνσεις και το HolyArrs την κρύβει στο δικό του αρχείο καταγραφής (log). Ένα reverse proxy μπροστά μπορεί και πάλι να καταγράφει ολόκληρη τη διεύθυνση.

Κανόνες για τα κλειδιά

Κάθε πλευρά έχει δικό της κλειδί, που φτιάχνεται μόνο σε αυτή την κάρτα. Τα κλειδιά API του HolyArrs (που ξεκινούν με hak_) δεν δουλεύουν εδώ, και αυτά τα κλειδιά δεν δουλεύουν πουθενά αλλού.
Ένα κλειδί ενεργεί ως ο άνθρωπος που το έφτιαξε, ο οποίος χρειάζεται δικαίωμα διαχείρισης της Βιβλιοθήκης. Το Prowlarr χρειάζεται και δικαίωμα αλλαγής ρυθμίσεων.
Αν αυτός ο άνθρωπος απενεργοποιηθεί ή χάσει το δικαίωμα, οι εφαρμογές απορρίπτονται μέχρι να φτιάξει κάποιος νέο κλειδί. Η κάρτα σε προειδοποιεί.

Διαχείριση με το API του HolyArrs

Συνδεδεμένος με τον κωδικό πρόσβασής σου. Οι κλήσεις για κλειδιά χρειάζονται πρόσφατη σύνδεση με κωδικό.

Τι	Κλήση
Ανάγνωση διακοπτών, διευθύνσεων και κλειδιών	`GET /api/v1/settings/old-app-api`
Ενεργοποίηση	`PUT /api/v1/settings/old-app-api` με `{"enabled": true}`
Να διαγράφουν αρχεία οι εφαρμογές	`PUT /api/v1/settings/old-app-api` με `{"delete_files": true}`
Δημιουργία κλειδιού πλευράς Sonarr	`POST /api/v1/settings/old-app-api/keys/sonarr`
Δημιουργία κλειδιού πλευράς Radarr	`POST /api/v1/settings/old-app-api/keys/radarr`
Αφαίρεση κλειδιού	`DELETE /api/v1/settings/old-app-api/keys/sonarr` (ή `radarr`)

Σχετικά

Το HolyArrs είναι δωρεάν. Αν σου γλίτωσε χρόνο, βάλε του αστέρι στο GitHub, γίνε χορηγός ή κέρασέ με έναν καφέ.