API per sviluppatori
Una piccola API di sola lettura per le parti pubbliche e pseudonime di 1in8B: le note che i giocatori lasciano sulle vite concluse e i link che condividono. Senza chiavi, senza account e senza costi.
A chi è rivolta
A ricercatori, studenti e appassionati che vogliono consultare la parte pubblica e pseudonima di 1in8B senza aprire un browser. L'API fornisce gli stessi dati mostrati dal sito pubblico: non espone dati privati e non sottrae nulla al gioco.
Feed delle note condivise
GET https://in8b.com/api/posts?lang=en restituisce le note condivise più recenti in formato JSON: {"ok":true,"posts":[…],"more":false}. Ogni post contiene id, lang, name (il nome di un personaggio fittizio), iso (un codice paese), sex, age, text, rem (il numero di giocatori che l'hanno ricordato) e at (il tempo Unix in millisecondi). Aggiungi &before=<last id> per scorrere le pagine indietro nel tempo. lang filtra le note in base a un codice lingua del sito; se ometti il parametro o scrivi male il codice, vengono restituite note in tutte le lingue mescolate tra loro, quindi specifica lang=en per ottenere quelle in inglese.
Link alle vite condivise
Un risultato condivisibile può essere pubblicato come link breve: https://in8b.com/s/<key>. Aprendo il link vengono mostrati soltanto un nome visualizzato, un paese e un'età. I link vengono conservati per 120 giorni; diari, scelte e cause di morte non sono mai inclusi.
Individuare le pagine del sito
https://in8b.com/robots.txt riporta le regole di scansione e https://in8b.com/sitemap.xml elenca tutte le pagine pubbliche, compresa questa.
Regole di base
Cita 1in8B (in8b.com) quando presenti i dati. Limitati a circa una richiesta al secondo e usa la cache dove possibile. I contenuti sono di fantasia e si basano su statistiche pubbliche dei vari paesi: non presentarli mai come una previsione su una persona reale e non usarli per creare una copia del gioco o addestrare modelli che lo imitino.
Cosa non è pubblico
La pubblicazione, il ricordo, la segnalazione e l'eliminazione delle note restano funzioni interne al gioco, con le proprie protezioni, e non fanno parte di questa API. I backup di Cloud Life Keep, i diari e le vite non ancora concluse non vengono mai esposti. Le chiamate dal browser verso un'origine diversa non sono abilitate, quindi leggi il feed da un server. Non sono previsti account, pannelli delle quote o pagine di stato; se una chiamata non riesce, attendi e riprova più tardi.
Modifiche e contatti
Gli endpoint possono cambiare con l'evoluzione del gioco; le modifiche sostanziali saranno indicate in questa pagina. Domande e segnalazioni: [email protected].