1
0
mirror of https://github.com/twirl/The-API-Book.git synced 2025-11-29 22:07:39 +02:00

typos & style fix

This commit is contained in:
Sergey Konstantinov
2023-04-25 10:35:00 +03:00
parent 22cc6692b5
commit 4ec0e03e1c
17 changed files with 1272 additions and 1433 deletions

Binary file not shown.

File diff suppressed because one or more lines are too long

Binary file not shown.

Binary file not shown.

File diff suppressed because one or more lines are too long

Binary file not shown.

View File

@@ -44,9 +44,9 @@
</nav>
<p>API-first development is one of the hottest technical topics nowadays since many companies started to realize that API serves as a multiplicator to their opportunities—but it also amplifies the design mistakes as well.</p>
<p>This book is written to share the expertise and describe the best practices in designing and developing APIs. It comprises six sections dedicated to:</p>
<ul><li>the API design</li>
<ul><li>The API design</li>
<li>— API patterns</li>
<li>backwards compatibility</li>
<li>Backwards compatibility</li>
<li>— HTTP API & REST</li>
<li>— SDK and UI libraries</li>
<li>— API product management.</ul>
@@ -59,95 +59,97 @@
<ul>
<li><a href="API.en.html#intro-structure">Chapter 1. On the Structure of This Book</a></li>
<li><a href="API.en.html#intro-api-definition">Chapter 2. The API Definition</a></li>
<li><a href="API.en.html#intro-api-quality">Chapter 3. API Quality Criteria</a></li>
<li><a href="API.en.html#intro-back-compat">Chapter 4. On Backwards Compatibility</a></li>
<li><a href="API.en.html#intro-versioning">Chapter 5. On Versioning</a></li>
<li><a href="API.en.html#intro-terms-notation">Chapter 6. Terms and Notation Keys</a></li>
<li><a href="API.en.html#intro-api-solutions-overview">Chapter 3. Overview of Existing API Development Solutions</a></li>
<li><a href="API.en.html#intro-api-quality">Chapter 4. API Quality Criteria</a></li>
<li><a href="API.en.html#intro-api-first-approach">Chapter 5. The API-first approach</a></li>
<li><a href="API.en.html#intro-back-compat">Chapter 6. On Backwards Compatibility</a></li>
<li><a href="API.en.html#intro-versioning">Chapter 7. On Versioning</a></li>
<li><a href="API.en.html#intro-terms-notation">Chapter 8. Terms and Notation Keys</a></li>
</ul>
</li>
<li>
<h4><a href="API.en.html#section-2">Section I. The API Design</a></h4>
<ul>
<li><a href="API.en.html#api-design-context-pyramid">Chapter 7. The API Contexts Pyramid</a></li>
<li><a href="API.en.html#api-design-defining-field">Chapter 8. Defining an Application Field</a></li>
<li><a href="API.en.html#api-design-separating-abstractions">Chapter 9. Separating Abstraction Levels</a></li>
<li><a href="API.en.html#api-design-isolating-responsibility">Chapter 10. Isolating Responsibility Areas</a></li>
<li><a href="API.en.html#api-design-describing-interfaces">Chapter 11. Describing Final Interfaces</a></li>
<li><a href="API.en.html#api-design-annex">Chapter 12. Annex to Section I. Generic API Example</a></li>
<li><a href="API.en.html#api-design-context-pyramid">Chapter 9. The API Contexts Pyramid</a></li>
<li><a href="API.en.html#api-design-defining-field">Chapter 10. Defining an Application Field</a></li>
<li><a href="API.en.html#api-design-separating-abstractions">Chapter 11. Separating Abstraction Levels</a></li>
<li><a href="API.en.html#api-design-isolating-responsibility">Chapter 12. Isolating Responsibility Areas</a></li>
<li><a href="API.en.html#api-design-describing-interfaces">Chapter 13. Describing Final Interfaces</a></li>
<li><a href="API.en.html#api-design-annex">Chapter 14. Annex to Section I. Generic API Example</a></li>
</ul>
</li>
<li>
<h4><a href="API.en.html#section-3">[Work in Progress] Section II. The API Patterns</a></h4>
<ul>
<li><a href="API.en.html#chapter-13">Chapter 13. On Design Patterns in the API Context</a></li>
<li><a href="API.en.html#chapter-14">Chapter 14. Authenticating Partners and Authorizing API Calls</a></li>
<li><a href="API.en.html#chapter-15">Chapter 15. Synchronization Strategies</a></li>
<li><a href="API.en.html#chapter-16">Chapter 16. Eventual Consistency</a></li>
<li><a href="API.en.html#chapter-17">Chapter 17. Asynchronicity and Time Management</a></li>
<li><a href="API.en.html#chapter-18">Chapter 18. Lists and Accessing Them</a></li>
<li><a href="API.en.html#chapter-19">Chapter 19. Bidirectional Data Flows. Push and Poll Models</a></li>
<li><a href="API.en.html#chapter-20">Chapter 20. Organization of Notification Systems</a></li>
<li><a href="API.en.html#chapter-21">Chapter 21. Atomicity</a></li>
<li><a href="API.en.html#chapter-22">Chapter 22. Partial Updates</a></li>
<li><a href="API.en.html#chapter-23">Chapter 23. Degradation and Predictability</a></li>
<li><a href="API.en.html#api-patterns-context">Chapter 15. On Design Patterns in the API Context</a></li>
<li><a href="API.en.html#api-patterns-aa">Chapter 16. Authenticating Partners and Authorizing API Calls</a></li>
<li><a href="API.en.html#api-patterns-sync-strategies">Chapter 17. Synchronization Strategies</a></li>
<li><a href="API.en.html#chapter-18">Chapter 18. Eventual Consistency</a></li>
<li><a href="API.en.html#chapter-19">Chapter 19. Asynchronicity and Time Management</a></li>
<li><a href="API.en.html#chapter-20">Chapter 20. Lists and Accessing Them</a></li>
<li><a href="API.en.html#chapter-21">Chapter 21. Bidirectional Data Flows. Push and Poll Models</a></li>
<li><a href="API.en.html#chapter-22">Chapter 22. Organization of Notification Systems</a></li>
<li><a href="API.en.html#chapter-23">Chapter 23. Atomicity</a></li>
<li><a href="API.en.html#chapter-24">Chapter 24. Partial Updates</a></li>
<li><a href="API.en.html#chapter-25">Chapter 25. Degradation and Predictability</a></li>
</ul>
</li>
<li>
<h4><a href="API.en.html#section-4">Section III. The Backwards Compatibility</a></h4>
<ul>
<li><a href="API.en.html#back-compat-statement">Chapter 24. The Backwards Compatibility Problem Statement</a></li>
<li><a href="API.en.html#back-compat-iceberg-waterline">Chapter 25. On the Waterline of the Iceberg</a></li>
<li><a href="API.en.html#back-compat-abstracting-extending">Chapter 26. Extending through Abstracting</a></li>
<li><a href="API.en.html#back-compat-strong-coupling">Chapter 27. Strong Coupling and Related Problems</a></li>
<li><a href="API.en.html#back-compat-weak-coupling">Chapter 28. Weak Coupling</a></li>
<li><a href="API.en.html#back-compat-universal-interfaces">Chapter 29. Interfaces as a Universal Pattern</a></li>
<li><a href="API.en.html#back-compat-serenity-notepad">Chapter 30. The Serenity Notepad</a></li>
<li><a href="API.en.html#back-compat-statement">Chapter 26. The Backwards Compatibility Problem Statement</a></li>
<li><a href="API.en.html#back-compat-iceberg-waterline">Chapter 27. On the Waterline of the Iceberg</a></li>
<li><a href="API.en.html#back-compat-abstracting-extending">Chapter 28. Extending through Abstracting</a></li>
<li><a href="API.en.html#back-compat-strong-coupling">Chapter 29. Strong Coupling and Related Problems</a></li>
<li><a href="API.en.html#back-compat-weak-coupling">Chapter 30. Weak Coupling</a></li>
<li><a href="API.en.html#back-compat-universal-interfaces">Chapter 31. Interfaces as a Universal Pattern</a></li>
<li><a href="API.en.html#back-compat-serenity-notepad">Chapter 32. The Serenity Notepad</a></li>
</ul>
</li>
<li>
<h4><a href="API.en.html#section-5">[Work in Progress] Section IV. The HTTP API & REST</a></h4>
<ul>
<li><a href="API.en.html#chapter-31">Chapter 31. On HTTP API Concept and Terminology</a></li>
<li><a href="API.en.html#chapter-32">Chapter 32. The REST Myth</a></li>
<li><a href="API.en.html#chapter-33">Chapter 33. The Semantics of the HTTP Request Components</a></li>
<li><a href="API.en.html#chapter-34">Chapter 34. The HTTP API Advantages and Disadvantages</a></li>
<li><a href="API.en.html#chapter-35">Chapter 35. HTTP API Organization Principles</a></li>
<li><a href="API.en.html#chapter-36">Chapter 36. Working with HTTP API Errors</a></li>
<li><a href="API.en.html#chapter-37">Chapter 37. Organizing the HTTP API Resources and Operations</a></li>
<li><a href="API.en.html#chapter-38">Chapter 38. Final Provisions and General Recommendations</a></li>
<li><a href="API.en.html#chapter-33">Chapter 33. On HTTP API Concept and Terminology</a></li>
<li><a href="API.en.html#chapter-34">Chapter 34. The REST Myth</a></li>
<li><a href="API.en.html#chapter-35">Chapter 35. The Semantics of the HTTP Request Components</a></li>
<li><a href="API.en.html#chapter-36">Chapter 36. The HTTP API Advantages and Disadvantages</a></li>
<li><a href="API.en.html#chapter-37">Chapter 37. HTTP API Organization Principles</a></li>
<li><a href="API.en.html#chapter-38">Chapter 38. Working with HTTP API Errors</a></li>
<li><a href="API.en.html#chapter-39">Chapter 39. Organizing the HTTP API Resources and Operations</a></li>
<li><a href="API.en.html#chapter-40">Chapter 40. Final Provisions and General Recommendations</a></li>
</ul>
</li>
<li>
<h4><a href="API.en.html#section-6">[Work in Progress] Section V. The SDK & UI Libraries</a></h4>
<ul>
<li><a href="API.en.html#chapter-39">Chapter 39. On the Content of This Section</a></li>
<li><a href="API.en.html#chapter-40">Chapter 40. The SDK: Problems and Solutions</a></li>
<li><a href="API.en.html#chapter-41">Chapter 41. The Code Generation Pattern</a></li>
<li><a href="API.en.html#chapter-42">Chapter 42. The UI Components</a></li>
<li><a href="API.en.html#chapter-43">Chapter 43. Decomposing UI Components</a></li>
<li><a href="API.en.html#chapter-44">Chapter 44. The MV* Frameworks</a></li>
<li><a href="API.en.html#chapter-45">Chapter 45. The Backend-Driven UI</a></li>
<li><a href="API.en.html#chapter-46">Chapter 46. Shared Resources and Asynchronous Locks</a></li>
<li><a href="API.en.html#chapter-47">Chapter 47. Computed Properties</a></li>
<li><a href="API.en.html#chapter-48">Chapter 48. Conclusion</a></li>
<li><a href="API.en.html#chapter-41">Chapter 41. On the Content of This Section</a></li>
<li><a href="API.en.html#chapter-42">Chapter 42. The SDK: Problems and Solutions</a></li>
<li><a href="API.en.html#chapter-43">Chapter 43. The Code Generation Pattern</a></li>
<li><a href="API.en.html#chapter-44">Chapter 44. The UI Components</a></li>
<li><a href="API.en.html#chapter-45">Chapter 45. Decomposing UI Components</a></li>
<li><a href="API.en.html#chapter-46">Chapter 46. The MV* Frameworks</a></li>
<li><a href="API.en.html#chapter-47">Chapter 47. The Backend-Driven UI</a></li>
<li><a href="API.en.html#chapter-48">Chapter 48. Shared Resources and Asynchronous Locks</a></li>
<li><a href="API.en.html#chapter-49">Chapter 49. Computed Properties</a></li>
<li><a href="API.en.html#chapter-50">Chapter 50. Conclusion</a></li>
</ul>
</li>
<li>
<h4><a href="API.en.html#section-7">Section VI. The API Product</a></h4>
<ul>
<li><a href="API.en.html#api-product">Chapter 49. API as a Product</a></li>
<li><a href="API.en.html#api-product-business-models">Chapter 50. The API Business Models</a></li>
<li><a href="API.en.html#api-product-vision">Chapter 51. Developing a Product Vision</a></li>
<li><a href="API.en.html#api-product-devrel">Chapter 52. Communicating with Developers</a></li>
<li><a href="API.en.html#api-product-business-comms">Chapter 53. Communicating with Business Owners</a></li>
<li><a href="API.en.html#api-product-range">Chapter 54. The API Services Range</a></li>
<li><a href="API.en.html#api-product-kpi">Chapter 55. The API Key Performance Indicators</a></li>
<li><a href="API.en.html#api-product-antifraud">Chapter 56. Identifying Users and Preventing Fraud</a></li>
<li><a href="API.en.html#api-product-tos-violations">Chapter 57. The Technical Means of Preventing ToS Violations</a></li>
<li><a href="API.en.html#api-product-customer-support">Chapter 58. Supporting customers</a></li>
<li><a href="API.en.html#api-product-documentation">Chapter 59. The Documentation</a></li>
<li><a href="API.en.html#api-product-testing">Chapter 60. The Testing Environment</a></li>
<li><a href="API.en.html#api-product-expectations">Chapter 61. Managing Expectations</a></li>
<li><a href="API.en.html#api-product">Chapter 51. API as a Product</a></li>
<li><a href="API.en.html#api-product-business-models">Chapter 52. The API Business Models</a></li>
<li><a href="API.en.html#api-product-vision">Chapter 53. Developing a Product Vision</a></li>
<li><a href="API.en.html#api-product-devrel">Chapter 54. Communicating with Developers</a></li>
<li><a href="API.en.html#api-product-business-comms">Chapter 55. Communicating with Business Owners</a></li>
<li><a href="API.en.html#api-product-range">Chapter 56. The API Services Range</a></li>
<li><a href="API.en.html#api-product-kpi">Chapter 57. The API Key Performance Indicators</a></li>
<li><a href="API.en.html#api-product-antifraud">Chapter 58. Identifying Users and Preventing Fraud</a></li>
<li><a href="API.en.html#api-product-tos-violations">Chapter 59. The Technical Means of Preventing ToS Violations</a></li>
<li><a href="API.en.html#api-product-customer-support">Chapter 60. Supporting customers</a></li>
<li><a href="API.en.html#api-product-documentation">Chapter 61. The Documentation</a></li>
<li><a href="API.en.html#api-product-testing">Chapter 62. The Testing Environment</a></li>
<li><a href="API.en.html#api-product-expectations">Chapter 63. Managing Expectations</a></li>
</ul>
</li>
</ul>

View File

@@ -40,7 +40,7 @@
<br />Подпишитесь на обновления на <a class="habr" href="https://habr.com/ru/users/forgotten/">Хабре</a>
<br/>Follow me on <a class="linkedin" href="https://www.linkedin.com/in/twirl/"></a> · <a class="twitter" href="https://twitter.com/blogovodoved"></a> · <a class="medium" href="https://twirl.medium.com/">Medium</a>
<br />Поддержите эту работу на <a class="patreon" href="https://www.patreon.com/yatwirl">Patreon</a>
<br />Поделиться: <a class="share share-vk" href="https://vk.com/share.php?url=https%3A%2F%2Ftwirl.github.io%2FThe-API-Book%2Findex.ru.html" target="_blank"></a> · <a class="share share-facebook" href="https://www.facebook.com/sharer.php?u=https%3A%2F%2Ftwirl.github.io%2FThe-API-Book%2Findex.ru.html" target="_blank"></a> · <a class="share share-twitter" href="https://twitter.com/intent/tweet?text=%C2%ABAPI%C2%BB%20%D0%A1%D0%B5%D1%80%D0%B3%D0%B5%D1%8F%20%D0%9A%D0%BE%D0%BD%D1%81%D1%82%D0%B0%D0%BD%D1%82%D0%B8%D0%BD%D0%BE%D0%B2%D0%B0%20%E2%80%94%20%D0%BA%D0%BD%D0%B8%D0%B3%D0%B0%20%D0%BE%20%D0%B4%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD%D0%B5%20API%20%D0%B8%20%D0%B5%D0%B3%D0%BE%20%D0%BF%D1%80%D0%BE%D0%B4%D1%83%D0%BA%D1%82%D0%BE%D0%B2%D0%BE%D0%BC%20%D0%B8%20%D1%82%D0%B5%D1%85%D0%BD%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%BC%20%D1%80%D0%B0%D0%B7%D0%B2%D0%B8%D1%82%D0%B8%D0%B8&url=https%3A%2F%2Ftwirl.github.io%2FThe-API-Book%2Findex.ru.html&hashtags=API%2CTheAPIBook&via=blogovodoved" target="_blank"></a> · <a class="share share-linkedin" href="https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Ftwirl.github.io%2FThe-API-Book%2Findex.ru.html" target="_blank"></a> · <a class="share share-reddit" href="http://www.reddit.com/submit?url=https%3A%2F%2Ftwirl.github.io%2FThe-API-Book%2Findex.ru.html&title=%C2%ABAPI%C2%BB%20%D0%A1%D0%B5%D1%80%D0%B3%D0%B5%D1%8F%20%D0%9A%D0%BE%D0%BD%D1%81%D1%82%D0%B0%D0%BD%D1%82%D0%B8%D0%BD%D0%BE%D0%B2%D0%B0%20%E2%80%94%20%D0%BA%D0%BD%D0%B8%D0%B3%D0%B0%20%D0%BE%20%D0%B4%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD%D0%B5%20API%20%D0%B8%20%D0%B5%D0%B3%D0%BE%20%D0%BF%D1%80%D0%BE%D0%B4%D1%83%D0%BA%D1%82%D0%BE%D0%B2%D0%BE%D0%BC%20%D0%B8%20%D1%82%D0%B5%D1%85%D0%BD%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%BC%20%D1%80%D0%B0%D0%B7%D0%B2%D0%B8%D1%82%D0%B8%D0%B8" target="_blank"></a><br/>⚙️⚙️⚙️
<br />Поделиться: <a class="share share-facebook" href="https://www.facebook.com/sharer.php?u=https%3A%2F%2Ftwirl.github.io%2FThe-API-Book%2Findex.ru.html" target="_blank"></a> · <a class="share share-twitter" href="https://twitter.com/intent/tweet?text=%C2%ABAPI%C2%BB%20%D0%A1%D0%B5%D1%80%D0%B3%D0%B5%D1%8F%20%D0%9A%D0%BE%D0%BD%D1%81%D1%82%D0%B0%D0%BD%D1%82%D0%B8%D0%BD%D0%BE%D0%B2%D0%B0%20%E2%80%94%20%D0%BA%D0%BD%D0%B8%D0%B3%D0%B0%20%D0%BE%20%D0%B4%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD%D0%B5%20API%20%D0%B8%20%D0%B5%D0%B3%D0%BE%20%D0%BF%D1%80%D0%BE%D0%B4%D1%83%D0%BA%D1%82%D0%BE%D0%B2%D0%BE%D0%BC%20%D0%B8%20%D1%82%D0%B5%D1%85%D0%BD%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%BC%20%D1%80%D0%B0%D0%B7%D0%B2%D0%B8%D1%82%D0%B8%D0%B8&url=https%3A%2F%2Ftwirl.github.io%2FThe-API-Book%2Findex.ru.html&hashtags=API%2CTheAPIBook&via=blogovodoved" target="_blank"></a> · <a class="share share-linkedin" href="https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Ftwirl.github.io%2FThe-API-Book%2Findex.ru.html" target="_blank"></a> · <a class="share share-reddit" href="http://www.reddit.com/submit?url=https%3A%2F%2Ftwirl.github.io%2FThe-API-Book%2Findex.ru.html&title=%C2%ABAPI%C2%BB%20%D0%A1%D0%B5%D1%80%D0%B3%D0%B5%D1%8F%20%D0%9A%D0%BE%D0%BD%D1%81%D1%82%D0%B0%D0%BD%D1%82%D0%B8%D0%BD%D0%BE%D0%B2%D0%B0%20%E2%80%94%20%D0%BA%D0%BD%D0%B8%D0%B3%D0%B0%20%D0%BE%20%D0%B4%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD%D0%B5%20API%20%D0%B8%20%D0%B5%D0%B3%D0%BE%20%D0%BF%D1%80%D0%BE%D0%B4%D1%83%D0%BA%D1%82%D0%BE%D0%B2%D0%BE%D0%BC%20%D0%B8%20%D1%82%D0%B5%D1%85%D0%BD%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%BC%20%D1%80%D0%B0%D0%B7%D0%B2%D0%B8%D1%82%D0%B8%D0%B8" target="_blank"></a><br/>⚙️⚙️⚙️
</nav>
<p>«API-first» подход — одна из самых горячих горячих тем в разработке программного обеспечения в наше время. Многие компании начали понимать, что API выступает мультипликатором их возможностей — но также умножает и допущенные ошибки.</p>
<p>Эта книга написана для того, чтобы поделиться опытом и изложить лучшие практики разработки API. Книга состоит из шести разделов, посвящённых:</p>
@@ -59,95 +59,97 @@
<ul>
<li><a href="API.ru.html#intro-structure">Глава 1. О структуре этой книги</a></li>
<li><a href="API.ru.html#intro-api-definition">Глава 2. Определение API</a></li>
<li><a href="API.ru.html#intro-api-quality">Глава 3. Критерии качества API</a></li>
<li><a href="API.ru.html#intro-back-compat">Глава 4. Обратная совместимость</a></li>
<li><a href="API.ru.html#intro-versioning">Глава 5. О версионировании</a></li>
<li><a href="API.ru.html#intro-terms-notation">Глава 6. Условные обозначения и терминология</a></li>
<li><a href="API.ru.html#intro-api-solutions-overview">Глава 3. Обзор существующих решений в области разработки API</a></li>
<li><a href="API.ru.html#intro-api-quality">Глава 4. Критерии качества API</a></li>
<li><a href="API.ru.html#intro-api-first-approach">Глава 5. API-first подход</a></li>
<li><a href="API.ru.html#intro-back-compat">Глава 6. Обратная совместимость</a></li>
<li><a href="API.ru.html#intro-versioning">Глава 7. О версионировании</a></li>
<li><a href="API.ru.html#intro-terms-notation">Глава 8. Условные обозначения и терминология</a></li>
</ul>
</li>
<li>
<h4><a href="API.ru.html#section-2">Раздел I. Проектирование API</a></h4>
<ul>
<li><a href="API.ru.html#api-design-context-pyramid">Глава 7. Пирамида контекстов API</a></li>
<li><a href="API.ru.html#api-design-defining-field">Глава 8. Определение области применения</a></li>
<li><a href="API.ru.html#api-design-separating-abstractions">Глава 9. Разделение уровней абстракции</a></li>
<li><a href="API.ru.html#api-design-isolating-responsibility">Глава 10. Разграничение областей ответственности</a></li>
<li><a href="API.ru.html#api-design-describing-interfaces">Глава 11. Описание конечных интерфейсов</a></li>
<li><a href="API.ru.html#api-design-annex">Глава 12. Приложение к разделу I. Модельный API</a></li>
<li><a href="API.ru.html#api-design-context-pyramid">Глава 9. Пирамида контекстов API</a></li>
<li><a href="API.ru.html#api-design-defining-field">Глава 10. Определение области применения</a></li>
<li><a href="API.ru.html#api-design-separating-abstractions">Глава 11. Разделение уровней абстракции</a></li>
<li><a href="API.ru.html#api-design-isolating-responsibility">Глава 12. Разграничение областей ответственности</a></li>
<li><a href="API.ru.html#api-design-describing-interfaces">Глава 13. Описание конечных интерфейсов</a></li>
<li><a href="API.ru.html#api-design-annex">Глава 14. Приложение к разделу I. Модельный API</a></li>
</ul>
</li>
<li>
<h4><a href="API.ru.html#section-3">[В разработке] Раздел II. Паттерны дизайна API</a></h4>
<ul>
<li><a href="API.ru.html#chapter-13">Глава 13. О паттернах проектирования в контексте API</a></li>
<li><a href="API.ru.html#chapter-14">Глава 14. Аутентификация партнёров и авторизация вызовов API</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. Двунаправленные потоки данных. Push и poll-модели</a></li>
<li><a href="API.ru.html#chapter-20">Глава 20. Варианты организации системы нотификаций</a></li>
<li><a href="API.ru.html#chapter-21">Глава 21. Атомарность</a></li>
<li><a href="API.ru.html#chapter-22">Глава 22. Частичные обновления</a></li>
<li><a href="API.ru.html#chapter-23">Глава 23. Деградация и предсказуемость</a></li>
<li><a href="API.ru.html#chapter-15">Глава 15. О паттернах проектирования в контексте API</a></li>
<li><a href="API.ru.html#api-patterns-aa">Глава 16. Аутентификация партнёров и авторизация вызовов API</a></li>
<li><a href="API.ru.html#api-patterns-sync-strategies">Глава 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>
<li><a href="API.ru.html#chapter-20">Глава 20. Списки и организация доступа к ним</a></li>
<li><a href="API.ru.html#api-patterns-push-vs-poll">Глава 21. Двунаправленные потоки данных. Push и poll-модели</a></li>
<li><a href="API.ru.html#chapter-22">Глава 22. Варианты организации системы нотификаций</a></li>
<li><a href="API.ru.html#chapter-23">Глава 23. Атомарность</a></li>
<li><a href="API.ru.html#chapter-24">Глава 24. Частичные обновления</a></li>
<li><a href="API.ru.html#chapter-25">Глава 25. Деградация и предсказуемость</a></li>
</ul>
</li>
<li>
<h4><a href="API.ru.html#section-4">Раздел III. Обратная совместимость</a></h4>
<ul>
<li><a href="API.ru.html#back-compat-statement">Глава 24. Постановка проблемы обратной совместимости</a></li>
<li><a href="API.ru.html#back-compat-iceberg-waterline">Глава 25. О ватерлинии айсберга</a></li>
<li><a href="API.ru.html#back-compat-abstracting-extending">Глава 26. Расширение через абстрагирование</a></li>
<li><a href="API.ru.html#back-compat-strong-coupling">Глава 27. Сильная связность и сопутствующие проблемы</a></li>
<li><a href="API.ru.html#back-compat-weak-coupling">Глава 28. Слабая связность</a></li>
<li><a href="API.ru.html#back-compat-universal-interfaces">Глава 29. Интерфейсы как универсальный паттерн</a></li>
<li><a href="API.ru.html#back-compat-serenity-notepad">Глава 30. Блокнот душевного покоя</a></li>
<li><a href="API.ru.html#back-compat-statement">Глава 26. Постановка проблемы обратной совместимости</a></li>
<li><a href="API.ru.html#back-compat-iceberg-waterline">Глава 27. О ватерлинии айсберга</a></li>
<li><a href="API.ru.html#back-compat-abstracting-extending">Глава 28. Расширение через абстрагирование</a></li>
<li><a href="API.ru.html#back-compat-strong-coupling">Глава 29. Сильная связность и сопутствующие проблемы</a></li>
<li><a href="API.ru.html#back-compat-weak-coupling">Глава 30. Слабая связность</a></li>
<li><a href="API.ru.html#back-compat-universal-interfaces">Глава 31. Интерфейсы как универсальный паттерн</a></li>
<li><a href="API.ru.html#back-compat-serenity-notepad">Глава 32. Блокнот душевного покоя</a></li>
</ul>
</li>
<li>
<h4><a href="API.ru.html#section-5">[В разработке] Раздел IV. HTTP API и REST</a></h4>
<ul>
<li><a href="API.ru.html#chapter-31">Глава 31. О концепции HTTP API и терминологии</a></li>
<li><a href="API.ru.html#chapter-32">Глава 32. Мифология REST</a></li>
<li><a href="API.ru.html#chapter-33">Глава 33. Составляющие HTTP запросов и их семантика</a></li>
<li><a href="API.ru.html#chapter-34">Глава 34. Преимущества и недостатки HTTP API</a></li>
<li><a href="API.ru.html#chapter-35">Глава 35. Принципы организации HTTP API</a></li>
<li><a href="API.ru.html#chapter-36">Глава 36. Работа с ошибками в HTTP API</a></li>
<li><a href="API.ru.html#chapter-37">Глава 37. Организация URL ресурсов и операций над ними в HTTP API</a></li>
<li><a href="API.ru.html#chapter-38">Глава 38. Заключительные положения и общие рекомендации</a></li>
<li><a href="API.ru.html#chapter-33">Глава 33. О концепции HTTP API и терминологии</a></li>
<li><a href="API.ru.html#chapter-34">Глава 34. Мифология REST</a></li>
<li><a href="API.ru.html#chapter-35">Глава 35. Составляющие HTTP запросов и их семантика</a></li>
<li><a href="API.ru.html#chapter-36">Глава 36. Преимущества и недостатки HTTP API</a></li>
<li><a href="API.ru.html#chapter-37">Глава 37. Принципы организации HTTP API</a></li>
<li><a href="API.ru.html#chapter-38">Глава 38. Работа с ошибками в HTTP API</a></li>
<li><a href="API.ru.html#chapter-39">Глава 39. Организация URL ресурсов и операций над ними в HTTP API</a></li>
<li><a href="API.ru.html#chapter-40">Глава 40. Заключительные положения и общие рекомендации</a></li>
</ul>
</li>
<li>
<h4><a href="API.ru.html#section-6">[В разработке] Раздел V. SDK и UI</a></h4>
<ul>
<li><a href="API.ru.html#chapter-39">Глава 39. О содержании раздела</a></li>
<li><a href="API.ru.html#chapter-40">Глава 40. SDK: проблемы и решения</a></li>
<li><a href="API.ru.html#chapter-41">Глава 41. Кодогенерация</a></li>
<li><a href="API.ru.html#chapter-42">Глава 42. UI-компоненты</a></li>
<li><a href="API.ru.html#chapter-43">Глава 43. Декомпозиция UI-компонентов. MV*-подходы</a></li>
<li><a href="API.ru.html#chapter-44">Глава 44. MV*-фреймворки</a></li>
<li><a href="API.ru.html#chapter-45">Глава 45. Backend-Driven UI</a></li>
<li><a href="API.ru.html#chapter-46">Глава 46. Разделяемые ресурсы и асинхронные блокировки</a></li>
<li><a href="API.ru.html#chapter-47">Глава 47. Вычисляемые свойства</a></li>
<li><a href="API.ru.html#chapter-48">Глава 48. В заключение</a></li>
<li><a href="API.ru.html#chapter-41">Глава 41. О содержании раздела</a></li>
<li><a href="API.ru.html#chapter-42">Глава 42. SDK: проблемы и решения</a></li>
<li><a href="API.ru.html#chapter-43">Глава 43. Кодогенерация</a></li>
<li><a href="API.ru.html#chapter-44">Глава 44. UI-компоненты</a></li>
<li><a href="API.ru.html#chapter-45">Глава 45. Декомпозиция UI-компонентов. MV*-подходы</a></li>
<li><a href="API.ru.html#chapter-46">Глава 46. MV*-фреймворки</a></li>
<li><a href="API.ru.html#chapter-47">Глава 47. Backend-Driven UI</a></li>
<li><a href="API.ru.html#chapter-48">Глава 48. Разделяемые ресурсы и асинхронные блокировки</a></li>
<li><a href="API.ru.html#chapter-49">Глава 49. Вычисляемые свойства</a></li>
<li><a href="API.ru.html#chapter-50">Глава 50. В заключение</a></li>
</ul>
</li>
<li>
<h4><a href="API.ru.html#section-7">Раздел VI. API как продукт</a></h4>
<ul>
<li><a href="API.ru.html#api-product">Глава 49. Продукт API</a></li>
<li><a href="API.ru.html#api-product-business-models">Глава 50. Бизнес-модели API</a></li>
<li><a href="API.ru.html#api-product-vision">Глава 51. Формирование продуктового видения</a></li>
<li><a href="API.ru.html#api-product-devrel">Глава 52. Взаимодействие с разработчиками</a></li>
<li><a href="API.ru.html#api-product-business-comms">Глава 53. Взаимодействие с бизнес-аудиторией</a></li>
<li><a href="API.ru.html#api-product-range">Глава 54. Линейка сервисов API</a></li>
<li><a href="API.ru.html#api-product-kpi">Глава 55. Ключевые показатели эффективности API</a></li>
<li><a href="API.ru.html#api-product-antifraud">Глава 56. Идентификация пользователей и борьба с фродом</a></li>
<li><a href="API.ru.html#api-product-tos-violations">Глава 57. Технические способы борьбы с несанкционированным доступом к API</a></li>
<li><a href="API.ru.html#api-product-customer-support">Глава 58. Поддержка пользователей API</a></li>
<li><a href="API.ru.html#api-product-documentation">Глава 59. Документация</a></li>
<li><a href="API.ru.html#api-product-testing">Глава 60. Тестовая среда</a></li>
<li><a href="API.ru.html#api-product-expectations">Глава 61. Управление ожиданиями</a></li>
<li><a href="API.ru.html#api-product">Глава 51. Продукт API</a></li>
<li><a href="API.ru.html#api-product-business-models">Глава 52. Бизнес-модели API</a></li>
<li><a href="API.ru.html#api-product-vision">Глава 53. Формирование продуктового видения</a></li>
<li><a href="API.ru.html#api-product-devrel">Глава 54. Взаимодействие с разработчиками</a></li>
<li><a href="API.ru.html#api-product-business-comms">Глава 55. Взаимодействие с бизнес-аудиторией</a></li>
<li><a href="API.ru.html#api-product-range">Глава 56. Линейка сервисов API</a></li>
<li><a href="API.ru.html#api-product-kpi">Глава 57. Ключевые показатели эффективности API</a></li>
<li><a href="API.ru.html#api-product-antifraud">Глава 58. Идентификация пользователей и борьба с фродом</a></li>
<li><a href="API.ru.html#api-product-tos-violations">Глава 59. Технические способы борьбы с несанкционированным доступом к API</a></li>
<li><a href="API.ru.html#api-product-customer-support">Глава 60. Поддержка пользователей API</a></li>
<li><a href="API.ru.html#api-product-documentation">Глава 61. Документация</a></li>
<li><a href="API.ru.html#api-product-testing">Глава 62. Тестовая среда</a></li>
<li><a href="API.ru.html#api-product-expectations">Глава 63. Управление ожиданиями</a></li>
</ul>
</li>
</ul>