API voor ontwikkelaars
Een kleine API met alleen leestoegang tot de openbare, pseudonieme delen van 1in8B: de notities die spelers over beëindigde levens achterlaten en de links die ze delen. Geen sleutels, geen accounts, geen kosten.
Voor wie deze API bedoeld is
Voor onderzoekers, studenten en hobbyisten die de openbare, pseudonieme kant van 1in8B willen lezen zonder een browser te openen. De API levert dezelfde gegevens als de openbare website: er worden geen privégegevens toegevoegd en er wordt niets uit het spel weggenomen.
Feed met gedeelde notities
GET https://in8b.com/api/posts?lang=en geeft de meest recente gedeelde notities terug als JSON: {"ok":true,"posts":[…],"more":false}. Elk bericht bevat id, lang, name (een fictieve naam uit een leven), iso (een landcode), sex, age, text, rem (hoeveel spelers het hebben herdacht) en at (Unix-tijd in milliseconden). Voeg &before=<last id> toe om pagina voor pagina oudere berichten op te halen. lang filtert op een taalcode van de website; als je de parameter weglaat of de code verkeerd spelt, worden notities in alle talen door elkaar teruggegeven, dus geef lang=en mee voor notities in het Engels.
Links naar gedeelde levens
Een deelbaar resultaat kan als korte link worden gepubliceerd: https://in8b.com/s/<key>. Bij het openen van de link worden alleen een weergavenaam, een land en een leeftijd getoond. Links worden 120 dagen bewaard; dagboeken, keuzes en doodsoorzaken worden nooit opgenomen.
Pagina’s van de website vinden
https://in8b.com/robots.txt bevat de crawlregels en https://in8b.com/sitemap.xml vermeldt alle openbare pagina’s, waaronder deze.
Basisregels
Vermeld 1in8B (in8b.com) als bron wanneer je de gegevens presenteert. Beperk je tot ongeveer één verzoek per seconde en sla waar mogelijk gegevens op in een cache. De inhoud is fictief en gebaseerd op openbare landenstatistieken: presenteer deze nooit als een voorspelling over een echte persoon en gebruik deze niet om een kopie van het spel te bouwen of modellen te trainen die het nabootsen.
Wat niet openbaar is
Notities plaatsen, herdenken, melden en verwijderen blijft binnen het spel, met eigen beveiligingen, en maakt geen deel uit van deze API. Back-ups van Cloud Life Keep, dagboeken en nog niet beëindigde levens worden nooit beschikbaar gesteld. Browseraanroepen naar een andere oorsprong zijn niet ingeschakeld, dus lees de feed vanaf een server. Er is geen account, quotadashboard of statuspagina; als een aanroep mislukt, wacht dan en probeer het later opnieuw.
Wijzigingen en contact
Endpoints kunnen veranderen naarmate het spel zich ontwikkelt; belangrijke wijzigingen worden op deze pagina vermeld. Vragen en meldingen: [email protected].