API dla programistów
Niewielkie API tylko do odczytu, udostępniające publiczne, pseudonimowe treści z 1in8B: notatki graczy o zakończonych życiach oraz udostępniane przez nich linki. Bez kluczy, kont i opłat.
Dla kogo jest to API
Dla badaczy, studentów i hobbystów, którzy chcą odczytywać publiczne, pseudonimowe treści z 1in8B bez otwierania przeglądarki. API udostępnia te same dane co publiczna strona: nie ujawnia żadnych danych prywatnych i niczego nie odbiera grze.
Kanał udostępnionych notatek
GET /api/posts?lang=en zwraca najnowsze udostępnione notatki w formacie JSON: {"ok":true,"posts":[…],"more":false}. Każdy wpis zawiera id, lang, name (fikcyjne imię postaci z danego życia), iso (kod kraju), sex, age, text, rem (liczbę graczy, którzy zapamiętali wpis) oraz at (czas uniksowy w milisekundach). Dodaj &before=<last id>, aby przeglądać starsze wpisy strona po stronie. lang filtruje notatki według kodu języka witryny; jeśli pominiesz ten parametr lub błędnie wpiszesz kod, zwrócone zostaną notatki we wszystkich językach, wymieszane ze sobą, więc aby otrzymać notatki po angielsku, podaj lang=en.
Linki do udostępnionych żyć
Wynik przeznaczony do udostępnienia można opublikować jako krótki link: /s/<key>. Po otwarciu linku widoczne są wyłącznie nazwa wyświetlana, kraj i wiek. Linki są przechowywane przez 120 dni; nigdy nie zawierają dzienników, wyborów ani przyczyn śmierci.
Odnajdywanie stron witryny
/robots.txt zawiera reguły skanowania, a /sitemap.xml wymienia wszystkie publiczne strony, w tym tę stronę.
Podstawowe zasady
Podawaj 1in8B (in8b.com) jako źródło przy prezentowaniu danych. Ogranicz liczbę żądań do około jednego na sekundę i korzystaj z pamięci podręcznej, gdy to możliwe. Treści są fikcyjne i powstają na podstawie publicznych statystyk dotyczących krajów: nigdy nie przedstawiaj ich jako prognozy dotyczącej rzeczywistej osoby ani nie używaj ich do tworzenia kopii gry lub trenowania modeli, które ją naśladują.
Co nie jest publiczne
Publikowanie, upamiętnianie, zgłaszanie i usuwanie notatek pozostaje wewnątrz gry, podlega odrębnym zabezpieczeniom i nie jest częścią tego API. Kopie zapasowe Cloud Life Keep, dzienniki i niezakończone życia nigdy nie są udostępniane. Wywołania z przeglądarki do innego źródła nie są włączone, dlatego kanał należy odczytywać z serwera. Nie ma kont, panelu limitów ani strony stanu; jeśli wywołanie się nie powiedzie, odczekaj i spróbuj później.
Zmiany i kontakt
Endpointy mogą się zmieniać wraz z rozwojem gry; istotne zmiany będą odnotowywane na tej stronie. Pytania i zgłoszenia: [email protected].