واجهة API للتطبيقات الأقدم

خبير

وجّه تطبيقًا لا يعرف إلا Sonarr أو Radarr إلى HolyArrs. أعطه عنوانًا ينتهي بـ /sonarr أو /radarr ومفتاحًا، فيعامل HolyArrs على أنه ذلك التطبيق.

هذه واجهة API صغيرة مصنوعة لتلك التطبيقات فقط. لسكربتاتك الخاصة، استخدم واجهة 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`، بأي حالة أحرف	`/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

صيغة الاستعلام مقبولة على هذه العناوين فقط، ويخفيها HolyArrs في سجل تشغيله. أما الوكيل العكسي (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`)