1in8B

API توسعه‌دهندگان

یک API کوچک و فقط‌خواندنی برای بخش‌های عمومی 1in8B که با نام مستعار منتشر می‌شوند: یادداشت‌هایی که بازیکنان دربارهٔ زندگی‌های پایان‌یافته می‌گذارند و پیوندهایی که به اشتراک می‌گذارند. بدون نیاز به کلید یا حساب، و رایگان.

این API برای چه کسانی است

پژوهشگران، دانشجویان و علاقه‌مندانی که می‌خواهند بدون باز کردن مرورگر، بخش عمومی 1in8B را که با نام مستعار منتشر می‌شود بخوانند. این 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) را به‌عنوان منبع ذکر کنید. نرخ درخواست‌ها را حدود 1 درخواست در ثانیه نگه دارید و هرچه می‌توانید در حافظهٔ نهان ذخیره کنید. محتوا داستانی است و از آمار عمومی کشورها بهره می‌گیرد؛ هرگز آن را پیش‌بینی دربارهٔ یک فرد واقعی معرفی نکنید و از آن برای ساخت نسخه‌ای کپی از بازی یا آموزش مدل‌هایی که آن را تقلید می‌کنند استفاده نکنید.

چه چیزهایی عمومی نیستند

انتشار، به خاطر سپردن، گزارش و حذف یادداشت‌ها با سازوکارهای حفاظتی خودشان درون بازی می‌مانند و بخشی از این API نیستند. نسخه‌های پشتیبان Cloud Life Keep، یادداشت‌های روزانه و زندگی‌های ناتمام هرگز در دسترس عموم قرار نمی‌گیرند. فراخوانی‌های مرورگر از مبدأهای دیگر فعال نیستند؛ پس خوراک را از یک سرور بخوانید. حساب، داشبورد سهمیه یا صفحهٔ وضعیت وجود ندارد؛ اگر فراخوانی ناموفق بود، صبر کنید و بعداً دوباره تلاش کنید.

تغییرات و تماس

ممکن است با تکامل بازی، endpointها تغییر کنند؛ تغییرات مهم در همین صفحه اعلام می‌شوند. پرسش‌ها و گزارش‌ها: [email protected].

زبان