The-API-Book/docs/index.ru.html


<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <link rel="icon" type="image/png" href="assets/favicon.png" />
    <title>
        Сергей Константинов. API
    </title>
    <meta
        name="description"
        content="Разработка API — особый навык: API является как мультипликатором ваших возможностей, так и мультипликатором ваших ошибок. Эта книга написана для того, чтобы поделиться опытом и изложить лучшие практики проектирования API. Книга состоит из двух больших разделов. В первом разделе мы поговорим о проектировании API на стадии разработки концепции — как грамотно выстроить архитектуру, от крупноблочного планирования до конечных интерфейсов. Второй раздел посвящён развитию существующих API с сохранением обратной совместимости"
    />
    <meta property="og:type" content="article" />
    <meta
        property="og:title"
        content="Сергей Константинов. API"
    />
    <meta
        property="og:description"
        content="Разработка API — особый навык: API является как мультипликатором ваших возможностей, так и мультипликатором ваших ошибок. Эта книга написана для того, чтобы поделиться опытом и изложить лучшие практики проектирования API. Книга состоит из двух больших разделов. В первом разделе мы поговорим о проектировании API на стадии разработки концепции — как грамотно выстроить архитектуру, от крупноблочного планирования до конечных интерфейсов. Второй раздел посвящён развитию существующих API с сохранением обратной совместимости"
    />
    <meta property="og:image" content="assets/header.png" />
    <meta
        property="og:url"
        content="https://github.com/twirl/The-API-Book"
    />
    <link rel="stylesheet" href="assets/landing.css"/>
</head>
<body>
    <nav>
        <img
            class="header"
            src="assets/header.jpg"
            alt="Сергей Константинов. API"
        /><br />
        <h1>Сергей Константинов<br/><span class="title">API</span></h1>
        <h2>Бесплатная электронная книга</h2>
        <br />Подпишитесь на обновления на <a class="habr" href="https://habr.com/ru/users/forgotten/posts/">Хабре</a>
        
        <br />Поддержите эту работу на <a class="patreon" href="https://www.patreon.com/yatwirl">Patreon</a>
        <br />⚙️⚙️⚙️
    </nav>
    <p>«API-first» подход — одна из самых горячих горячих тем в разработке программного обеспечения в наше время. Многие компании начали понимать, что API выступает мультипликатором их возможностей — но также умножает и допущенные ошибки.</p>
<p>Эта книга посвящена проектированию API: как правильно выстроить архитектуру, начиная с высокоуровневого планирования и заканчивая деталями реализации конкретных интерфейсов, и как развивать API, не нарушая обратную совместимость.</p>
<p>Иллюстрации и вдохновение: Maria Konstantinova &middot; <a href="https://www.instagram.com/art.mari.ka/">art.mari.ka</a>.</p>
    <p>Вы можете скачать книгу «API» в формате <a href="API.ru.pdf">PDF</a>, <a href="API.ru.epub">EPUB</a>, или <a href="API.ru.html">прочитать её онлайе</a>.
    </p>
    <h3>Содержание</h3>
    <ul><li>
                <h4><a href="API.ru.html#section-1">Введение</a></h4>
                <ul>
                    <li><a href="API.ru.html#chapter-1">Глава 1. О структуре этой книги</a></li>
<li><a href="API.ru.html#chapter-2">Глава 2. Определение API</a></li>
<li><a href="API.ru.html#chapter-3">Глава 3. Критерии качества API</a></li>
<li><a href="API.ru.html#chapter-4">Глава 4. Обратная совместимость</a></li>
<li><a href="API.ru.html#chapter-5">Глава 5. О версионировании</a></li>
<li><a href="API.ru.html#chapter-6">Глава 6. Условные обозначения и терминология</a></li>
                            </ul>
            </li>
<li>
                <h4><a href="API.ru.html#section-2">Раздел I. Проектирование API</a></h4>
                <ul>
                    <li><a href="API.ru.html#chapter-7">Глава 7. Пирамида контекстов API</a></li>
<li><a href="API.ru.html#chapter-8">Глава 8. Определение области применения</a></li>
<li><a href="API.ru.html#chapter-9">Глава 9. Разделение уровней абстракции</a></li>
<li><a href="API.ru.html#chapter-10">Глава 10. Разграничение областей ответственности</a></li>
<li><a href="API.ru.html#chapter-11">Глава 11. Описание конечных интерфейсов</a></li>
<li><a href="API.ru.html#chapter-12">Глава 12. Приложение к разделу I. Модельный API</a></li>
                            </ul>
            </li>
<li>
                <h4><a href="API.ru.html#section-3">Раздел II. Обратная совместимость</a></h4>
                <ul>
                    <li><a href="API.ru.html#chapter-13">Глава 13. Постановка проблемы обратной совместимости</a></li>
<li><a href="API.ru.html#chapter-14">Глава 14. О ватерлинии айсберга</a></li>
<li><a href="API.ru.html#chapter-15">Глава 15. Расширение через абстрагирование</a></li>
<li><a href="API.ru.html#chapter-16">Глава 16. Сильная связность и сопутствующие проблемы</a></li>
<li><a href="API.ru.html#chapter-17">Глава 17. Слабая связность</a></li>
<li><a href="API.ru.html#chapter-18">Глава 18. Интерфейсы как универсальный паттерн</a></li>
<li><a href="API.ru.html#chapter-19">Глава 19. Блокнот душевного покоя</a></li>
                            </ul>
            </li>
<li>
                <h4>Часть III. API как продукт</h4>
                <ul>
                    <li>Глава 20. Продукт API</li>
<li>Глава 21. Бизнес-модели API</li>
<li>Глава 22. Формирование продуктового видения</li>
<li>Глава 23. Взаимодействие с разработчиками</li>
<li>Глава 24. Взаимодействие с бизнес-аудиторией</li>
<li>Глава 25. Линейка сервисов API</li>
<li>Глава 26. Ключевые показатели эффективности API</li>
<li>Глава 27. Идентификация пользователей и борьба с фродом</li>
<li>Глава 28. Информационная безопасность</li>
<li>Глава 29. Поддержка пользователей</li>
<li>Глава 30. Документация</li>
<li>Глава 31. Тестовая среда</li>
<li>Глава 32. Управление ожиданиями</li>
                            </ul>
            </li>
    </ul>
    <p>Это произведение доступно по <a href="http://creativecommons.org/licenses/by-nc/4.0/">лицензии Creative Commons «Attribution-NonCommercial» («Атрибуция — Некоммерческое использование») 4.0 Всемирная</a>.</p>
    <p>Исходный код доступен на <a href="https://github.com/twirl/The-API-Book">github.com/twirl/The-API-Book</a></p>
    <h3><a name="about-author">Об авторе</a></h3>
    <section class="about-me">
        <aside><img src="https://konstantinov.cc/static/me.png"/><br/>Фото: <a href="http://linkedin.com/in/zloylos/">Denis Hananein</a></aside>
        <div class="content">
        <p>Сергей Константинов работает с API уже больше десятилетия. Он начинал свою карьеру разработчиком в подразделении API Яндекс.Карт, и со временем стал руководителем всего сервиса, отвечая и за техническую, и за продуктовую составляющую.</p>
<p>За это время Сергей получил уникальный опыт построения API мирового уровня с дневной аудторией в десятки миллионов человек, планирования роадмапов для такого продукта и многочисленных публичных выступлений. Он также проработал полтора года в составе Технической архитектурной группы W3C.</p>
<p>После девяти лет в Картах Сергей переключился на технические роли в других департаментах и компаниях, занимаясь интеграционными проектами и будучи ответственным за техническую архитектуру целых продуктов компании. Сегодня Сергей живёт в Таллинне, Эстония, и работает ведущим инженером в компании Bolt.</p></div>
    </section>
    <p>You might also <a href="index.html">read ‘The API’ in English</a>.</p>
</body>
</html>
new build script 2022-07-07 00:41:03 +03:00
Landing Page 2022-06-23 23:28:55 +03:00			`<!DOCTYPE html>`
			`<html>`
new build script 2022-07-07 00:41:03 +03:00			`<head>`
			`<meta charset="utf-8" />`
			`<meta name="viewport" content="width=device-width, initial-scale=1" />`
small build fixes + fresh build 2022-07-10 23:34:14 +03:00			`<link rel="icon" type="image/png" href="assets/favicon.png" />`
new build script 2022-07-07 00:41:03 +03:00			`<title>`
fresh build 2022-07-08 22:08:14 +03:00			`Сергей Константинов. API`
new build script 2022-07-07 00:41:03 +03:00			`</title>`
			`<meta`
			`name="description"`
			content="Разработка API — особый навык: API является как мультипликатором ваших возможностей, так и мультипликатором ваших ошибок. Эта книга написана для того, чтобы поделиться опытом и изложить лучшие практики проектирования API. Книга состоит из двух больших разделов. В первом разделе мы поговорим о проектировании API на стадии разработки концепции — как грамотно выстроить архитектуру, от крупноблочного планирования до конечных интерфейсов. Второй раздел посвящён развитию существующих API с сохранением обратной совместимости"
			`/>`
			`<meta property="og:type" content="article" />`
			`<meta`
			`property="og:title"`
fresh build 2022-07-08 22:08:14 +03:00			`content="Сергей Константинов. API"`
new build script 2022-07-07 00:41:03 +03:00			`/>`
			`<meta`
			`property="og:description"`
			content="Разработка API — особый навык: API является как мультипликатором ваших возможностей, так и мультипликатором ваших ошибок. Эта книга написана для того, чтобы поделиться опытом и изложить лучшие практики проектирования API. Книга состоит из двух больших разделов. В первом разделе мы поговорим о проектировании API на стадии разработки концепции — как грамотно выстроить архитектуру, от крупноблочного планирования до конечных интерфейсов. Второй раздел посвящён развитию существующих API с сохранением обратной совместимости"
			`/>`
			`<meta property="og:image" content="assets/header.png" />`
			`<meta`
			`property="og:url"`
			`content="https://github.com/twirl/The-API-Book"`
			`/>`
About author 2022-07-31 15:08:37 +03:00			`<link rel="stylesheet" href="assets/landing.css"/>`
new build script 2022-07-07 00:41:03 +03:00			`</head>`
			`<body>`
			`<nav>`
			`<img`
About author 2022-07-31 15:08:37 +03:00			`class="header"`
new build script 2022-07-07 00:41:03 +03:00			`src="assets/header.jpg"`
fresh build 2022-07-08 22:08:14 +03:00			`alt="Сергей Константинов. API"`
new build script 2022-07-07 00:41:03 +03:00			`/><br />`
fresh build 2022-07-08 22:08:14 +03:00			`<h1>Сергей Константинов<br/><span class="title">API</span></h1>`
new build script 2022-07-07 00:41:03 +03:00			`<h2>Бесплатная электронная книга</h2>`
			`<br />Подпишитесь на обновления на <a class="habr" href="https://habr.com/ru/users/forgotten/posts/">Хабре</a>`

			`<br />Поддержите эту работу на <a class="patreon" href="https://www.patreon.com/yatwirl">Patreon</a>`
			`<br />⚙️⚙️⚙️`
			`</nav>`
			`<p>«API-first» подход — одна из самых горячих горячих тем в разработке программного обеспечения в наше время. Многие компании начали понимать, что API выступает мультипликатором их возможностей — но также умножает и допущенные ошибки.</p>`
			`<p>Эта книга посвящена проектированию API: как правильно выстроить архитектуру, начиная с высокоуровневого планирования и заканчивая деталями реализации конкретных интерфейсов, и как развивать API, не нарушая обратную совместимость.</p>`
About author 2022-07-31 15:08:37 +03:00			`<p>Иллюстрации и вдохновение: Maria Konstantinova · <a href="https://www.instagram.com/art.mari.ka/">art.mari.ka</a>.</p>`
new build script 2022-07-07 00:41:03 +03:00			`<p>Вы можете скачать книгу «API» в формате <a href="API.ru.pdf">PDF</a>, <a href="API.ru.epub">EPUB</a>, или <a href="API.ru.html">прочитать её онлайе</a>.`
			`</p>`
			`<h3>Содержание</h3>`
			`<ul><li>`
			`<h4><a href="API.ru.html#section-1">Введение</a></h4>`
Landing Page 2022-06-23 23:28:55 +03:00			`<ul>`
new build script 2022-07-07 00:41:03 +03:00			`<li><a href="API.ru.html#chapter-1">Глава 1. О структуре этой книги</a></li>`
			`<li><a href="API.ru.html#chapter-2">Глава 2. Определение API</a></li>`
			`<li><a href="API.ru.html#chapter-3">Глава 3. Критерии качества API</a></li>`
			`<li><a href="API.ru.html#chapter-4">Глава 4. Обратная совместимость</a></li>`
			`<li><a href="API.ru.html#chapter-5">Глава 5. О версионировании</a></li>`
			`<li><a href="API.ru.html#chapter-6">Глава 6. Условные обозначения и терминология</a></li>`
			`</ul>`
Landing Page 2022-06-23 23:28:55 +03:00			`</li>`
new build script 2022-07-07 00:41:03 +03:00			`<li>`
			`<h4><a href="API.ru.html#section-2">Раздел I. Проектирование API</a></h4>`
Landing Page 2022-06-23 23:28:55 +03:00			`<ul>`
new build script 2022-07-07 00:41:03 +03:00			`<li><a href="API.ru.html#chapter-7">Глава 7. Пирамида контекстов API</a></li>`
			`<li><a href="API.ru.html#chapter-8">Глава 8. Определение области применения</a></li>`
			`<li><a href="API.ru.html#chapter-9">Глава 9. Разделение уровней абстракции</a></li>`
			`<li><a href="API.ru.html#chapter-10">Глава 10. Разграничение областей ответственности</a></li>`
			`<li><a href="API.ru.html#chapter-11">Глава 11. Описание конечных интерфейсов</a></li>`
			`<li><a href="API.ru.html#chapter-12">Глава 12. Приложение к разделу I. Модельный API</a></li>`
			`</ul>`
Landing Page 2022-06-23 23:28:55 +03:00			`</li>`
new build script 2022-07-07 00:41:03 +03:00			`<li>`
			`<h4><a href="API.ru.html#section-3">Раздел II. Обратная совместимость</a></h4>`
Landing Page 2022-06-23 23:28:55 +03:00			`<ul>`
new build script 2022-07-07 00:41:03 +03:00			`<li><a href="API.ru.html#chapter-13">Глава 13. Постановка проблемы обратной совместимости</a></li>`
			`<li><a href="API.ru.html#chapter-14">Глава 14. О ватерлинии айсберга</a></li>`
			`<li><a href="API.ru.html#chapter-15">Глава 15. Расширение через абстрагирование</a></li>`
			`<li><a href="API.ru.html#chapter-16">Глава 16. Сильная связность и сопутствующие проблемы</a></li>`
			`<li><a href="API.ru.html#chapter-17">Глава 17. Слабая связность</a></li>`
			`<li><a href="API.ru.html#chapter-18">Глава 18. Интерфейсы как универсальный паттерн</a></li>`
			`<li><a href="API.ru.html#chapter-19">Глава 19. Блокнот душевного покоя</a></li>`
			`</ul>`
Landing Page 2022-06-23 23:28:55 +03:00			`</li>`
new build script 2022-07-07 00:41:03 +03:00			`<li>`
			`<h4>Часть III. API как продукт</h4>`
Landing Page 2022-06-23 23:28:55 +03:00			`<ul>`
			`<li>Глава 20. Продукт API</li>`
new build script 2022-07-07 00:41:03 +03:00			`<li>Глава 21. Бизнес-модели API</li>`
			`<li>Глава 22. Формирование продуктового видения</li>`
			`<li>Глава 23. Взаимодействие с разработчиками</li>`
			`<li>Глава 24. Взаимодействие с бизнес-аудиторией</li>`
			`<li>Глава 25. Линейка сервисов API</li>`
			`<li>Глава 26. Ключевые показатели эффективности API</li>`
			`<li>Глава 27. Идентификация пользователей и борьба с фродом</li>`
			`<li>Глава 28. Информационная безопасность</li>`
			`<li>Глава 29. Поддержка пользователей</li>`
			`<li>Глава 30. Документация</li>`
			`<li>Глава 31. Тестовая среда</li>`
			`<li>Глава 32. Управление ожиданиями</li>`
			`</ul>`
Landing Page 2022-06-23 23:28:55 +03:00			`</li>`
new build script 2022-07-07 00:41:03 +03:00			`</ul>`
			`<p>Это произведение доступно по <a href="http://creativecommons.org/licenses/by-nc/4.0/">лицензии Creative Commons «Attribution-NonCommercial» («Атрибуция — Некоммерческое использование») 4.0 Всемирная</a>.</p>`
			`<p>Исходный код доступен на <a href="https://github.com/twirl/The-API-Book">github.com/twirl/The-API-Book</a></p>`
About author 2022-07-31 15:08:37 +03:00			`<h3><a name="about-author">Об авторе</a></h3>`
			`<section class="about-me">`
minor changes & fresh builds 2022-08-13 16:00:49 +03:00			`<aside><img src="https://konstantinov.cc/static/me.png"/><br/>Фото: <a href="http://linkedin.com/in/zloylos/">Denis Hananein</a></aside>`
About author 2022-07-31 15:08:37 +03:00			`<div class="content">`
			`<p>Сергей Константинов работает с API уже больше десятилетия. Он начинал свою карьеру разработчиком в подразделении API Яндекс.Карт, и со временем стал руководителем всего сервиса, отвечая и за техническую, и за продуктовую составляющую.</p>`
			<p>За это время Сергей получил уникальный опыт построения API мирового уровня с дневной аудторией в десятки миллионов человек, планирования роадмапов для такого продукта и многочисленных публичных выступлений. Он также проработал полтора года в составе Технической архитектурной группы W3C.</p>
			<p>После девяти лет в Картах Сергей переключился на технические роли в других департаментах и компаниях, занимаясь интеграционными проектами и будучи ответственным за техническую архитектуру целых продуктов компании. Сегодня Сергей живёт в Таллинне, Эстония, и работает ведущим инженером в компании Bolt.</p></div>
			`</section>`
			`<p>You might also <a href="index.html">read ‘The API’ in English</a>.</p>`
new build script 2022-07-07 00:41:03 +03:00			`</body>`
			`</html>`