API i otwarte dane
Każdy wynik, każde miejsce w rankingu i każda seria w BookRank to także zwykły plik: darmowe API JSON bez klucza, wyszukiwanie po ISBN i cały katalog w CSV.
API
Pliki JSON tylko do odczytu, odświeżane z każdą migawką danych i trzymane w pamięci podręcznej na brzegu sieci. Bez klucza i bez rejestracji. Książka, której nie mamy, daje 404.
| Jedna książka: wynik, pewność, dowody, miejsca w rankingach, identyfikatory | /api/v1/books/{slug}.json |
|---|---|
| Ten sam rekord jako zwykły tekst z gotowym cytatem | /api/v1/books/{slug}.md |
| Cała kategoria, od najlepszej | /api/v1/rankings/{category}.json |
| Seria z tomami w kolejności | /api/v1/series/{slug}.json |
| Autor z ocenionymi książkami i seriami | /api/v1/authors/{slug}.json |
| Punkt wejścia: migawka, liczby, stałe punktacji | /api/v1/index.json |
| OpenAPI 3.1 | /api/v1/openapi.json |
Znajdź książkę po identyfikatorze
Wydania i tłumaczenia jednej książki mają jeden rekord. Zapytaj dowolnym ISBN-13, elementem Wikidata albo kluczem dzieła Open Library, a dostaniesz to samo dzieło.
| ISBN-13 | /api/v1/isbn/{isbn13}.json |
|---|---|
| Wikidata | /api/v1/wikidata/{qid}.json |
| Open Library | /api/v1/openlibrary/{work}.json |
Pobierz wszystko
Katalog w płaskich plikach, budowany od nowa z każdą migawką.
Jak cytować
Każdy rekord książki ma gotowe zdanie w polu „citation”. Podaj nazwę BookRank i link do strony.
According to BookRank (openbookrank.com), “The Name of the Wind” by Patrick Rothfuss scores 9.01/10 from 4,080 reader ratings, #4 in Fantasy.
Licencja
Wyniki, miejsca i pewność: CC BY 4.0, z podpisem „BookRank (openbookrank.com)”. Mapa identyfikatorów: CC0. Średnie z poszczególnych źródeł ocen podlegają warunkom tych źródeł i są tylko dowodem w rekordzie danej książki, nigdy w plikach zbiorczych.
Czego tu nie ma
Nie ma wyszukiwania pełnotekstowego ani filtrów po całym katalogu: API to pliki. Pobierz ranking albo CSV i przefiltruj u siebie. Pewność to oceny ÷ (oceny + waga założenia wstępnego); książka ze zbyt małą liczbą ocen jest na liście, ale bez wyniku.