diff --git a/src/en/clean-copy/05-[Work in Progress] Section IV. HTTP APIs & REST Architectural Principles/06.md b/src/en/clean-copy/05-[Work in Progress] Section IV. HTTP APIs & REST Architectural Principles/06.md index ff637f6..9b113ea 100644 --- a/src/en/clean-copy/05-[Work in Progress] Section IV. HTTP APIs & REST Architectural Principles/06.md +++ b/src/en/clean-copy/05-[Work in Progress] Section IV. HTTP APIs & REST Architectural Principles/06.md @@ -1,4 +1,4 @@ -### [Designing a Nomenclature of URLs and Applicable Operations][http-api-urls-crud] +### [Designing a Nomenclature of URLs. CRUD Operations][http-api-urls-crud] As we noted on several occasions in the previous chapters, neither the HTTP and URL standards nor REST architectural principles prescribe concrete semantics for the meaningful parts of a URL (notably, path fragments and key-value pairs in the query). **The rules for organizing URLs in an HTTP API exist *only* to improve the API's readability and consistency from the developers' perspective**. However, this doesn't mean they are unimportant. Quite the opposite: URLs in HTTP APIs are a means of describing abstraction levels and entities' responsibility areas. A well-designed API hierarchy should be reflected in a well-designed URL nomenclature. diff --git a/src/ru/clean-copy/05-[В разработке] Раздел IV. HTTP API и REST/06.md b/src/ru/clean-copy/05-[В разработке] Раздел IV. HTTP API и REST/06.md index df7c899..d18285c 100644 --- a/src/ru/clean-copy/05-[В разработке] Раздел IV. HTTP API и REST/06.md +++ b/src/ru/clean-copy/05-[В разработке] Раздел IV. HTTP API и REST/06.md @@ -1,4 +1,4 @@ -### [Разработка номенклатуры URL ресурсов и операций над ними][http-api-urls-crud] +### [Разработка номенклатуры URL ресурсов. CRUD-операции][http-api-urls-crud] Как мы уже отмечали в предыдущих главах, стандарты HTTP и URL, а также принципы REST, не предписывают определённой семантики значимым компонентам URL (в частности, частям path и парам ключ-значение в query). **Правила организации URL в HTTP API существуют *только* для читабельности кода и удобства разработчика**. Что, впрочем, совершенно не означает, что они неважны: напротив, URL в HTTP API являются средством выразить уровни абстракции и области ответственности объектов. Правильный дизайн иерархии сущностей в API должен быть отражён в правильном дизайне номенклатуры URL.