books/The-API-Book
1
0
Fork 0
mirror of https://github.com/twirl/The-API-Book.git synced 2025-07-12 22:50:21 +02:00
Code Issues Releases Activity

chapter renamed

Browse Source
This commit is contained in:
Sergey Konstantinov
2023-06-26 22:41:04 +03:00
parent 7fe889c18e
commit 60a2ca7eea
2 changed files with 2 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
src/en/clean-copy/05-[Work in Progress] Section IV. HTTP APIs & REST Architectural Principles/06.md
View File

@ -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.

2
src/ru/clean-copy/05-[В разработке] Раздел IV. HTTP API и REST/06.md
View File

@ -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.