開発者向け 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 のバックアップ、日記、未完了の人生は一切公開されません。ブラウザーからのクロスオリジン呼び出しには対応していないため、フィードはサーバーから取得してください。アカウント、利用枠のダッシュボード、稼働状況ページはありません。呼び出しに失敗した場合は、しばらく待ってから再試行してください。
変更とお問い合わせ
ゲームの発展に伴い、エンドポイントは変更される場合があります。重要な変更はこのページに記載します。ご質問や問題の報告先：[email protected]。