İçeriğe geç

Eski uygulama API'si

Uzman

Sadece Sonarr ya da Radarr’ı tanıyan bir uygulamayı HolyArrs’a yönlendir. Ona /sonarr ya da /radarr ile biten bir adres ve bir anahtar ver; HolyArrs’ı o uygulama sanır.

Bu, yalnızca o uygulamalar için yapılmış küçük bir API. Kendi betiklerin için HolyArrs API’sini kullan.

Varsayılan olarak kapalı. Kapalıyken /sonarr/ ve /radarr/ altındaki her adres 404 döner.

  1. Settings > API (Ayarlar > API) sayfasını aç.
  2. Requests from Seerr and Overseerr (Seerr ve Overseerr’dan gelen istekler) kartında Answer Seerr and Overseerr (Seerr ve Overseerr’a yanıt ver) anahtarını aç.
  3. Shows (Diziler) yanındaki Make key’e (anahtar üret) bas. Bu, Sonarr tarafının anahtarı. Hemen kopyala; bir kez gösterilir.
  4. Movies (Filmler) yanındaki Make key’e bas. Bu, Radarr tarafının anahtarı. Onu da kopyala.
  5. Karttaki her tarafın adresine bak, örneğin /sonarr. URL base varsa /holyarrs/sonarr görünür. Kartın gösterdiğini kullan.

Anahtar üretirken, parolanla yakın zamanda giriş yapmadıysan parolan yeniden sorulur. Sonra her uygulamayı kur: bkz. Eski uygulama API istemcileri.

Ayar Ne yapar Varsayılan
Answer Seerr and Overseerr /sonarr ile /radarr’ı birlikte açar ya da kapatır. Kapalı
Make key / New key O taraf için anahtar üretir. Yeni anahtar eskisini hemen durdurur.
Remove key O tarafın anahtarını siler. Onu kullanan uygulamalar reddedilir.
Let these apps delete files Kapalıyken, bir uygulamada başlığı kaldırmak dosyaları bırakır. Açıkken dosyalar, her HolyArrs silmesinde olduğu gibi önce bekletme klasörüne gider. Kapalı

Her anahtar için kart son 4 karakterini, kimin ürettiğini ve en son ne zaman kullanıldığını gösterir.

Anahtarı gönderme

HolyArrs anahtarı bulduğu ilk yerden okur, sıra aşağıdaki gibi. Önceki bir yerdeki yanlış anahtar, sonraki doğru olsa bile hata verir.

Sıra Yer Örnek
1 apikey sorgu değeri, büyük/küçük harf fark etmez /sonarr/api/v3/series?apikey=KEY
2 X-Api-Key başlığı X-Api-Key: KEY
3 Authorization başlığı, Bearer ile ya da onsuz Authorization: Bearer KEY
Terminal window
curl -H "X-Api-Key: KEY" http://your-server:6262/sonarr/api/v3/system/status

Sorgu biçimi sadece bu adreslerde kabul edilir ve HolyArrs onu kendi günlüğünde gizler. Önündeki bir ters proxy yine de tam adresi günlüğe yazabilir.

Anahtar kuralları
  • Her tarafın kendi anahtarı var ve yalnızca bu karttan üretilir. HolyArrs API anahtarları (hak_ ile başlayanlar) burada çalışmaz, bu anahtarlar da başka hiçbir yerde çalışmaz.
  • Anahtar, onu üreten kişi olarak davranır; o kişinin Kütüphane’yi yönetme izni olmalı. Prowlarr ayrıca ayarları değiştirme izni ister.
  • O kişi kapatılırsa ya da izni giderse, biri yeni anahtar üretene kadar uygulamalar reddedilir. Kart seni uyarır.
HolyArrs API'siyle yönet

Parolanla giriş yapmış olman gerekir. Anahtar çağrıları yakın zamanda parolayla girilmiş olmasını ister.

Ne Çağrı
Aç/kapat ayarlarını, adresleri ve anahtarları oku GET /api/v1/settings/old-app-api
Aç PUT /api/v1/settings/old-app-api ile {"enabled": true}
Uygulamaların dosya silmesine izin ver PUT /api/v1/settings/old-app-api ile {"delete_files": true}
Sonarr tarafının anahtarını üret POST /api/v1/settings/old-app-api/keys/sonarr
Radarr tarafının anahtarını üret POST /api/v1/settings/old-app-api/keys/radarr
Bir anahtarı kaldır DELETE /api/v1/settings/old-app-api/keys/sonarr (ya da radarr)

HolyArrs ücretsiz. Zamanından tasarruf ettirdiyse GitHub'da yıldızla, sponsor ol ya da bana bir kahve ısmarla.