Skip to content

Commit bb9cf32

Browse files
authored
Merge pull request #59 from ivanovmg/fix/missing-word
Add missing word in Section 20, Russian version
2 parents d213aa1 + efcdbcb commit bb9cf32

File tree

1 file changed

+2
-2
lines changed
  • src/ru/clean-copy/03-Раздел II. Паттерны дизайна API

1 file changed

+2
-2
lines changed

src/ru/clean-copy/03-Раздел II. Паттерны дизайна API/06.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -201,7 +201,7 @@ GET /v1/partners/{id}/offers/history↵
201201
1. Построение статистического отчёта (скажем, подсчёт конверсии по часам).
202202

203203
Для этих сценариев нам необходимо предоставить партнёру две операции со списками:
204-
1. Для первой задачи, получение в реальном всех новых элементов с момента последнего запроса.
204+
1. Для первой задачи, получение в реальном времени всех новых элементов с момента последнего запроса.
205205
2. Для второй задачи, перебор списка, т.е. получение всех запросов за указанный временной интервал.
206206

207207
Оба сценария покрываются `limit`/`offset`-схемой, но требуют значительных усилий при написании кода, так как партнёру в обоих случаях нужно как-то ориентироваться, на сколько элементов очередь событий сдвинулась с момента последнего запроса. Отдельно отметим, что использование `limit`/`offset`-подхода приводит к невозможности кэширования ответов — повторные запросы с той же парой `limit`/`offset` могут возвращать совершенно разные результаты.
@@ -350,4 +350,4 @@ GET /v1/orders/created-history↵
350350

351351
События иммутабельны, и их список только пополняется, следовательно, организовать перебор этого списка вполне возможно. Да, событие — это не то же самое, что и сам заказ: к моменту прочтения партнёром события, заказ уже давно может изменить статус. Но, тем не менее, мы предоставили возможность перебрать *все* новые заказы, пусть и не самым оптимальным образом.
352352

353-
**NB**: в вышеприведённых фрагментах кода мы опустили метаданные ответа — такие как общее число элементов в списке, флаг типа `has_more_items` для индикации необходимости продолжить перебор и т.д. Хотя эти метаданные необязательны (клиент узнает размер списка, когда переберёт его полностью), их наличие повышает удобство работы с API для разработчиков, и мы рекомендуем их добавлять.
353+
**NB**: в вышеприведённых фрагментах кода мы опустили метаданные ответа — такие как общее число элементов в списке, флаг типа `has_more_items` для индикации необходимости продолжить перебор и т.д. Хотя эти метаданные необязательны (клиент узнает размер списка, когда переберёт его полностью), их наличие повышает удобство работы с API для разработчиков, и мы рекомендуем их добавлять.

0 commit comments

Comments
 (0)