API keys zijn het stille lijm tussen NZB indexers en je automatiseringapps. Zonder keys zou Sonarr en Radarr elke keer dat een nieuwe aflevering verschijnt een mens in de browser nodig hebben. Met keys zoekt Prowlarr volgens schema, pakt een NZB en geeft het werk door aan SABnzbd terwijl jij slaapt. De meeste sites die alleen providers reviewen slaan deze laag over; keys zijn indexer credentials, geen NNTP wachtwoorden.
Behandel keys als wachtwoorden, want ze bepalen toegang tot je betaalde indexer quota en identificeren je account in logs. Gelekte keys duiken op paste sites op en worden zonder waarschuwing ingetrokken. Een paar minuten nette setup voorkomt weekend storingen die lijken op "Usenet ligt eruit" terwijl alleen de indexer API is geblokkeerd.
Waarom indexer API's bestaan
Indexers bieden HTTP endpoints die zoekresultaten en NZB links in machineleesbare vorm teruggeven. Newznab-compatible schema's domineren, zodat Prowlarr dezelfde connector vorm op veel sites kan hergebruiken met per-site URL's en keys. Caps endpoints adverteren categorieën en limieten zodat *arr apps geen onmogelijke queries blijven hameren.
API's vervangen scraping, dat kapot gaat zodra een site HTML herontwerpt. Stabiele keys laten operators eerlijk rate-limiten en misbruikers intrekken. Jouw kant van de deal is keys veilig opslaan en roteren na migraties of gelekte backups.
Waar keys staan en hoe je ze kopieert
Na het aanmaken van een indexer account open je profiel of API instellingen. Je ziet een willekeurige string, soms gelabeld als API key, API ID plus key paar, of RSS key varianten. Kopieer eenmaal naar het indexer formulier in Prowlarr; vermijd screenshots in Discord support threads.
Sommige indexers geven aparte keys voor RSS en API; gebruik het API key pad voor Prowlarr tenzij de site documentatie anders zegt. Als een indexer meerdere apps of keys aanbiedt, wijs één key toe aan je homelab zodat je die kunt intrekken zonder een telefoon RSS reader te breken.
Prowlarr setup flow
Voeg elke indexer toe als Newznab-compatible app in Prowlarr, plak base URL en key, test connectiviteit, en sync daarna naar Sonarr, Radarr, Lidarr en Readarr vanuit het Apps gedeelte. Sync verspreidt indexer definities zodat je keys niet handmatig in vier UI's hoeft over te typen.
Houd Prowlarr health in de gaten voor 401 en 429 fouten. Unauthorized betekent meestal een typo of verlopen lidmaatschap; too many requests betekent dat je minder apps, langzamere RSS sync of een hogere tier nodig hebt. Dieper client pairing staat in beste Usenet voor Prowlarr.
Beveiliging en rotatie gewoontes
Sla keys in Prowlarr's config backup versleuteld op als je instellingen exporteert. Na het klonen van een VM of delen van een compose file, ga ervan uit dat keys zijn gelekt en genereer opnieuw op de indexer site. Commit keys niet naar git; gebruik environment variables of secret stores voor container stacks zoals in homelab guides.
Indexer keys hangen niet samen met je Usenet provider wachtwoord op poort 563. Het compromitteren van de ene compromitteert de andere niet automatisch, maar hergebruik tussen diensten maakt incident response moeilijker. Trek oude keys in wanneer je een oude Prowlarr host buiten gebruik stelt.
Rate limits en meerdere apps
Elke indexer stelt eigen hourly of daily API caps in per lidmaatschap tier. Sonarr, Radarr en een handmatige zoektool op één key draaien kan quota uitputten voordat prime time releases landen. Spreid RSS intervallen en vermijd overbodige full-library searches na de eerste import.
Meerdere keys op één account zijn ongebruikelijk; meerdere indexers met elk één key is normaal. Als zoeken alleen voor één show faalt, check indexer maintenance pagina's voordat je NZB kwaliteit of provider completion de schuld geeft. Downloader basics staan in de SABnzbd setup guide.
Documenteer welke key bij welke homelab VM hoort voordat je schijven kloont. Genereer keys opnieuw na het terugzetten van oude backups naar productie zodat twee Prowlarr instances nooit onbewust één quota delen.
FAQ
- Is een API key hetzelfde als mijn Usenet provider wachtwoord?
- Nee. Provider credentials authenticeren NNTP; indexer keys authenticeren HTTP search API's.
- Rate limiten indexers API keys?
- Ja. Limieten variëren per tier; overschrijd ze en zoeken faalt tot het venster reset.
- Moet ik meerdere keys per indexer aanmaken?
- Alleen wanneer de site per-app keys aanbiedt. Anders is één homelab key gebruikelijk.
- Heb ik keys nodig als ik alleen Easynews web search gebruik?
- Browser search slaat Prowlarr over. Automatisering zonder indexers is onpraktisch voor Sonarr-grade libraries.