API та відкриті дані
Кожна оцінка, кожне місце й кожна серія на BookRank — це також звичайний файл: безкоштовне JSON API без ключа, пошук за ISBN і весь каталог у CSV.
API
Файли JSON лише для читання, що оновлюються з кожним знімком даних і кешуються на межі мережі. Без ключа й без реєстрації. Книга, якої в нас немає, повертає 404.
| Одна книга: оцінка, певність, докази, місця, ідентифікатори | /api/v1/books/{slug}.json |
|---|---|
| Той самий запис звичайним текстом із готовою цитатою | /api/v1/books/{slug}.md |
| Уся категорія, від найкращої | /api/v1/rankings/{category}.json |
| Серія з томами по порядку | /api/v1/series/{slug}.json |
| Автор з оціненими книгами та серіями | /api/v1/authors/{slug}.json |
| Точка входу: знімок, кількості, сталі оцінювання | /api/v1/index.json |
| OpenAPI 3.1 | /api/v1/openapi.json |
Знайдіть книгу за ідентифікатором
Видання й переклади однієї книги мають один запис. Запитайте будь-яким ISBN-13, елементом Wikidata або ключем твору Open Library — і отримаєте той самий твір.
| ISBN-13 | /api/v1/isbn/{isbn13}.json |
|---|---|
| Wikidata | /api/v1/wikidata/{qid}.json |
| Open Library | /api/v1/openlibrary/{work}.json |
Завантажте все
Каталог у пласких файлах, що збирається наново з кожним знімком.
Як цитувати
Кожен запис книги містить готове речення в полі «citation». Назвіть BookRank і дайте посилання на сторінку.
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.
Ліцензія
Оцінки, місця й певність: CC BY 4.0, з підписом «BookRank (openbookrank.com)». Таблиця ідентифікаторів: CC0. Середні з окремих джерел оцінок підпадають під умови цих джерел і подаються лише як доказ у записі книги, ніколи в масових файлах.
Чого тут немає
Немає повнотекстового пошуку й фільтрів по каталогу: API — це файли. Завантажте рейтинг або CSV і відфільтруйте самі. Певність — це оцінки ÷ (оцінки + попередня вага); книга із замалою кількістю оцінок є в переліку, але без оцінки.