আগের অ্যাপের API

বিশেষজ্ঞ

যে অ্যাপ শুধু Sonarr বা Radarr চেনে, তাকে HolyArrs-এর সঙ্গে জুড়ে দিন। /sonarr বা /radarr দিয়ে শেষ হওয়া একটি ঠিকানা আর একটি কী দিলে সে HolyArrs-কে সেই অ্যাপ বলেই ধরে নেয়।

এটি শুধু ওই অ্যাপগুলোর জন্য বানানো একটি ছোট API। আপনার নিজের স্ক্রিপ্টের জন্য HolyArrs API ব্যবহার করুন।

চালু করুন

এটি ডিফল্টে বন্ধ থাকে। বন্ধ থাকলে /sonarr/ আর /radarr/-এর নিচের প্রতিটি ঠিকানা 404 দেয়।

Settings > API (সেটিংস > API) খুলুন।
Requests from Seerr and Overseerr (Seerr আর Overseerr থেকে অনুরোধ) কার্ডে Answer Seerr and Overseerr (Seerr আর Overseerr-কে সাড়া দিন) চালু করুন।
Shows (সিরিজ)-এর পাশে Make key (কী বানান) চাপুন। এটি Sonarr-এর দিকের কী। এখনই কপি করুন; এটি একবারই দেখানো হয়।
Movies (মুভি)-র পাশে Make key চাপুন। এটি 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 নিজের লগে সেটি লুকিয়ে রাখে। সামনে থাকা একটি রিভার্স প্রক্সি তবুও পুরো ঠিকানা লগ করতে পারে।

কী-র নিয়ম

প্রতিটি দিকের নিজস্ব কী আছে, যা শুধু এই কার্ডেই বানানো হয়। HolyArrs API কী (যেগুলো hak_ দিয়ে শুরু) এখানে কাজ করে না, আর এই কী অন্য কোথাও কাজ করে না।
কী যিনি বানিয়েছেন তাঁর হয়েই কাজ করে, আর তাঁর লাইব্রেরি পরিচালনার পারমিশন থাকতে হবে। Prowlarr-এর সেটিংস বদলানোর পারমিশনও লাগে।
ওই ব্যক্তিকে বন্ধ করা হলে বা পারমিশন চলে গেলে, কেউ নতুন কী না বানানো পর্যন্ত অ্যাপগুলোর অনুরোধ গ্রহণ করা হয় না। কার্ড আপনাকে সতর্ক করে।

HolyArrs API দিয়ে পরিচালনা করুন

পাসওয়ার্ড দিয়ে সাইন ইন থাকতে হবে। কী-র কলের জন্য সাম্প্রতিক পাসওয়ার্ড সাইন ইন লাগে।

কী	কল
সুইচ, ঠিকানা আর কী পড়া	`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-এ স্টার দিন, স্পনসর করুন অথবা এক কাপ কফি কিনে দিন।