Entwickler-API
Eine kleine API mit reinem Lesezugriff auf die öffentlichen, pseudonymen Bereiche von 1in8B: die Notizen, die Spieler zu beendeten Leben hinterlassen, und die Links, die sie teilen. Keine Schlüssel, keine Konten, keine Kosten.
Für wen diese API gedacht ist
Für Forschende, Studierende und Hobbyentwickler, die die öffentliche, pseudonyme Seite von 1in8B ohne Browser lesen möchten. Die API liefert dieselben Daten wie die öffentliche Website: Sie legt keine privaten Daten offen und nimmt dem Spiel nichts weg.
Feed geteilter Notizen
GET /api/posts?lang=en gibt die zuletzt geteilten Notizen als JSON zurück: {"ok":true,"posts":[…],"more":false}. Jeder Beitrag enthält id, lang, name (den Namen einer fiktiven Spielfigur), iso (einen Ländercode), sex, age, text, rem (wie viele Spieler sich daran erinnert haben) und at (Unix-Zeit in Millisekunden). Hänge &before=<last id> an, um ältere Einträge seitenweise abzurufen. lang filtert nach einem Sprachcode der Website; lässt du den Parameter weg oder schreibst den Sprachcode falsch, werden Notizen aller Sprachen gemischt zurückgegeben; gib für Englisch daher lang=en an.
Geteilte Lebenslinks
Ein teilbares Ergebnis kann als Kurzlink veröffentlicht werden: /s/<key>. Beim Öffnen des Links werden nur ein Anzeigename, ein Land und ein Alter angezeigt. Links werden 120 Tage lang aufbewahrt; Tagebücher, Entscheidungen und Todesursachen sind niemals enthalten.
Öffentliche Seiten finden
/robots.txt enthält die Crawling-Regeln, und /sitemap.xml listet jede öffentliche Seite auf, einschließlich dieser Seite.
Grundregeln
Nenne 1in8B (in8b.com) als Quelle, wenn du die Daten präsentierst. Beschränke dich auf ungefähr eine Anfrage pro Sekunde und speichere Daten nach Möglichkeit im Cache. Die Inhalte sind fiktiv und orientieren sich an öffentlichen Länderstatistiken: Stelle sie niemals als Vorhersage über eine reale Person dar und verwende sie weder zum Nachbau des Spiels noch zum Trainieren von Modellen, die es nachahmen.
Was nicht öffentlich ist
Das Veröffentlichen, Erinnern, Melden und Löschen von Notizen bleibt innerhalb des Spiels durch eigene Schutzmechanismen abgesichert und gehört nicht zu dieser API. Cloud Life Keep-Backups, Tagebücher und noch nicht beendete Leben werden niemals offengelegt. Browseraufrufe von anderen Ursprüngen sind nicht freigeschaltet; lies den Feed daher von einem Server aus. Es gibt weder ein Konto noch eine Quotenübersicht oder eine Statusseite. Wenn ein Aufruf fehlschlägt, warte und versuche es später erneut.
Änderungen und Kontakt
Die Endpunkte können sich mit der Weiterentwicklung des Spiels ändern; wesentliche Änderungen werden auf dieser Seite vermerkt. Fragen und Fehlermeldungen: [email protected].