ডেভেলপার API
1in8B-এর সর্বজনীন, ছদ্মনামভিত্তিক অংশের জন্য ছোট একটি শুধু পড়ার API: শেষ হওয়া জীবন নিয়ে খেলোয়াড়দের লেখা নোট এবং তাঁদের শেয়ার করা লিংক। কোনো কী লাগে না, অ্যাকাউন্ট লাগে না, খরচও নেই।
এটি কাদের জন্য
যেসব গবেষক, শিক্ষার্থী ও শৌখিন ব্যবহারকারী ব্রাউজার না খুলে 1in8B-এর সর্বজনীন, ছদ্মনামভিত্তিক অংশ পড়তে চান, তাঁদের জন্য এই API। সর্বজনীন সাইটে যে ডেটা দেখানো হয়, API সেই একই ডেটা দেয়: এটি কোনো ব্যক্তিগত তথ্য যোগ করে না এবং গেম থেকেও কিছু সরিয়ে নেয় না।
শেয়ার করা নোটের ফিড
GET /api/posts?lang=en সর্বশেষ শেয়ার করা নোটগুলো JSON হিসেবে ফেরত দেয়: {"ok":true,"posts":[…],"more":false}. প্রতিটি পোস্টে থাকে id, lang, name (কাল্পনিক জীবনের চরিত্রের নাম), iso (দেশের কোড), sex, age, text, rem (কতজন খেলোয়াড় সেটিকে স্মরণ করেছেন) এবং at (মিলিসেকেন্ডে Unix সময়)। সময়ের হিসেবে আগের পৃষ্ঠাগুলো দেখতে &before=<last id> যোগ করুন। lang সাইটের ভাষার কোড অনুযায়ী নোট ফিল্টার করে; এই প্যারামিটার বাদ দিলে বা ভাষার কোড ভুল লিখলে সব ভাষার নোট মিশিয়ে ফেরত দেওয়া হয়, তাই ইংরেজি নোট পেতে lang=en পাঠান।
শেয়ার করা জীবনের লিংক
শেয়ার করার উপযোগী ফলাফল একটি সংক্ষিপ্ত লিংক হিসেবে প্রকাশ করা যায়: /s/<key>। লিংক খুললে শুধু প্রদর্শিত নাম, দেশ ও বয়স দেখা যায়। লিংক 120 দিন রাখা হয়; ডায়েরি, সিদ্ধান্ত ও মৃত্যুর কারণ কখনোই এতে অন্তর্ভুক্ত থাকে না।
সাইটের পৃষ্ঠা খুঁজে পাওয়া
/robots.txt-এ ক্রল করার নিয়ম রয়েছে এবং /sitemap.xml-এ এই পৃষ্ঠাসহ সব সর্বজনীন পৃষ্ঠার তালিকা রয়েছে।
মৌলিক নিয়ম
ডেটা উপস্থাপনের সময় উৎস হিসেবে 1in8B (in8b.com)-এর নাম উল্লেখ করুন। প্রতি সেকেন্ডে প্রায় একটি অনুরোধের মধ্যে ব্যবহার সীমিত রাখুন এবং সম্ভব হলে ডেটা ক্যাশ করুন। বিষয়বস্তু কাল্পনিক এবং বিভিন্ন দেশের প্রকাশ্য পরিসংখ্যান থেকে ধারণা নিয়ে তৈরি: এটিকে কখনো কোনো বাস্তব ব্যক্তি সম্পর্কে করা ভবিষ্যদ্বাণী হিসেবে উপস্থাপন করবেন না, এবং গেমের অনুলিপি তৈরি করতে বা সেটিকে অনুকরণ করে এমন মডেল প্রশিক্ষণ দিতে ব্যবহার করবেন না।
যা সর্বজনীন নয়
নোট পোস্ট করা, স্মরণ করা, রিপোর্ট করা ও মুছে ফেলার কাজ গেমের ভেতরেই নিজস্ব সুরক্ষাব্যবস্থার অধীনে থাকে এবং এই API-এর অংশ নয়। Cloud Life Keep-এর ব্যাকআপ, ডায়েরি ও অসমাপ্ত জীবন কখনো প্রকাশ করা হয় না। ব্রাউজার থেকে cross-origin কল চালু নেই, তাই সার্ভার থেকে ফিড পড়ুন। কোনো অ্যাকাউন্ট, কোটা ড্যাশবোর্ড বা স্ট্যাটাস পৃষ্ঠা নেই; কল ব্যর্থ হলে অপেক্ষা করে পরে আবার চেষ্টা করুন।
পরিবর্তন ও যোগাযোগ
গেমের বিকাশের সঙ্গে endpoint বদলাতে পারে; গুরুত্বপূর্ণ পরিবর্তন এই পৃষ্ঠায় জানানো হবে। প্রশ্ন ও রিপোর্ট: [email protected]।