গবেষকদের জন্য
এপিআই ও হার্ভেস্টিং
প্রকাশিত উৎসভান্ডার প্রোগ্রামের মাধ্যমে ব্যবহারের জন্য উন্মুক্ত। কোনো কি লাগে না, নিবন্ধন লাগে না, কোনো হারসীমার স্তরও নেই — কেবল প্রকাশিত ও সম্পাদকীয়ভাবে পর্যালোচিত উৎসগুলোই উন্মুক্ত করা হয়। প্রতিটি রেকর্ডের সঙ্গে তার কৃতিত্ব থাকে, এবং সেই কৃতিত্ব উদ্ধৃতি, এপিআই ও OAI-PMH — সবখানেই সমানভাবে পৌঁছে যায়।
রিড এপিআই
HTTPS-এর মাধ্যমে JSON। সাড়াগুলো limit ও offset দিয়ে পৃষ্ঠায় ভাগ করা থাকে, এবং প্রতিটিতে একটি total থাকে। সরাসরি সাড়া দেখতে নিচের যেকোনো পাথে যান।
| GET | /api/public/sources q, source_type, language, sort, limit, offset | প্রকাশিত উৎসের তালিকা, সর্বশেষগুলো আগে। |
| GET | /api/public/sources/{slug} | একটি উৎস, এর পূর্ণ উৎসসূত্র, স্বত্ব ও কৃতিত্বসহ। |
| GET | /api/public/facets | উৎসের ধরন ও ভাষা অনুযায়ী সংখ্যা, ফিল্টার তৈরির জন্য। |
| GET | /api/public/export format=jsonl (default) or csv | সম্পূর্ণ প্রকাশিত ক্যাটালগ, তারিখযুক্ত একটি ফাইলে। বিনামূল্যে, কোনো কি লাগে না। কেবল বর্ণনামূলক মেটাডেটা। |
| GET | /api/search q, source_type, language, limit, offset | শিরোনাম, বিবরণ ও কৃতিত্বজুড়ে কিওয়ার্ড অনুসন্ধান। |
OAI-PMH
গ্রন্থাগার ও অ্যাগ্রিগেটরদের জন্য মানসম্মত মেটাডেটা হার্ভেস্টিং (OAI-PMH 2.0, Dublin Core)। মূল URL: https://api.julyarchive.org/api/oai। প্রত্যাহার করা রেকর্ডগুলো deleted-স্ট্যাটাসের চিহ্ন (টুম্বস্টোন) হিসেবে প্রচার করা হয়, ফলে যে হার্ভেস্টারের কাছে আগে থেকেই কোনো রেকর্ড আছে, সেটি সরিয়ে নেওয়া হলে সে তা জানতে পারে।
| GET | ?verb=Identify | রিপোজিটরির নাম, প্রোটোকল সংস্করণ, প্রাচীনতম datestamp। |
| GET | ?verb=ListMetadataFormats | সমর্থিত ফরম্যাট। Dublin Core (oai_dc)। |
| GET | ?verb=ListRecords metadataPrefix=oai_dc, from, until, resumptionToken | পূর্ণ রেকর্ড, পৃষ্ঠাপ্রতি ১০০টি, একটি resumptionToken-সহ। |
| GET | ?verb=ListIdentifiers metadataPrefix=oai_dc, from, until | কেবল হেডার — ধাপে ধাপে (ইনক্রিমেন্টাল) হার্ভেস্টিংয়ের জন্য কম খরচের। |
| GET | ?verb=GetRecord identifier, metadataPrefix=oai_dc | OAI শনাক্তকারী দিয়ে একটি একক রেকর্ড (শনাক্তকারী খুঁজে নিন ListIdentifiers দিয়ে)। |
স্থায়ী শনাক্তকারী
প্রতিটি রেকর্ডের একটি ARK শনাক্তকারী আছে, যা /ark:/<naan>/<id>-এ রিজলভ হয়, ফলে URL বদলে গেলেও উদ্ধৃতি কাজ করতে থাকে। প্রতিটি উৎস পৃষ্ঠায় Chicago, MLA ও APA শৈলীতে একটি “উদ্ধৃত করুন” উইজেটও আছে।
শর্তাবলি
আর্কাইভ সংরক্ষণের উদ্দেশ্যে অনুলিপি রাখে; মূল উপাদানের স্বত্ব মূল প্রকাশক ও স্রষ্টাদের কাছেই থাকে, এবং প্রতিটি রেকর্ডে তার নিজস্ব স্বত্ব উল্লেখ করা থাকে। যথাযথ কৃতিত্ব দিয়ে পুনর্ব্যবহার করুন — রেকর্ডে যে কৃতিত্ব দেওয়া আছে, তা হুবহু উল্লেখ করুন। বড় পরিসরে কাজ করছেন, উৎসভান্ডারের মিরর তৈরি করছেন, কিংবা আর্কাইভের নিজস্ব মেটাডেটা, অনুবাদ বা টাইমলাইনের ওপর ভিত্তি করে কিছু গড়ছেন? দেখুন প্রাতিষ্ঠানিক প্রবেশাধিকার ও লাইসেন্সিং।