Newer
Older
book-metadata-service / src / main / resources / templates / index.html
@malexple malexple 17 hours ago 2 KB add UI
<!DOCTYPE html>
<html lang="ru" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Book Metadata Service — открытый каталог книжных метаданных</title>
    <th:block th:replace="~{fragments :: head-assets}"></th:block>
</head>
<body>

<nav th:replace="~{fragments :: nav}"></nav>

<main class="container">

    <hgroup>
        <h1>Открытый каталог книжных метаданных</h1>
        <p>Бесплатный публичный API для поиска метаданных книг по ISBN или названию —
           объединяет Open Library, Google Books, FantLab и другие источники в одну карточку.</p>
    </hgroup>

    <!-- Публичные счётчики — обновляются раз в час, см. DailyStatsScheduler -->
    <div class="grid" id="stats-grid">
        <article><hgroup><h3 id="stat-total">—</h3><p>книг в базе</p></hgroup></article>
        <article><hgroup><h3 id="stat-today">—</h3><p>добавлено сегодня</p></hgroup></article>
        <article><hgroup><h3 id="stat-authors">—</h3><p>уникальных авторов</p></hgroup></article>
        <article><hgroup><h3 id="stat-requests">—</h3><p>запросов сегодня</p></hgroup></article>
    </div>

    <section>
        <h2>Быстрый старт</h2>
        <p>Публичный поиск не требует ключа и ограничен 60 запросами в минуту с одного IP:</p>
        <pre><code>curl "https://ваш-домен/api/v1/search/isbn/9785171234567"
curl "https://ваш-домен/api/v1/search/title?q=Мастер+и+Маргарита"
curl "https://ваш-домен/api/v1/search?q=9785171234567"</code></pre>
        <p>
            Хотите создавать/обогащать карточки программно — напишите нам за партнёрским ключом
            (доступ по scope <code>PARTNER_WRITE</code>). Полная документация — в
            <a href="/swagger-ui/index.html">Swagger UI</a>.
        </p>
    </section>

    <section>
        <h2>Как это работает</h2>
        <p>
            Подробный разбор архитектуры (EAV-модель метаданных, provenance по источникам,
            почему мы не гадаем при неоднозначном поиске по названию) — в статье на Хабре:
        </p>
        <p><a href="#" target="_blank" rel="noopener">→ Статья на Habr (ссылка появится после публикации)</a></p>
    </section>

    <footer th:replace="~{fragments :: footer}"></footer>

</main>

<script src="/js/stats.js" defer></script>
</body>
</html>