1
0
mirror of https://github.com/twirl/The-API-Book.git synced 2025-03-29 20:51:01 +02:00
This commit is contained in:
Sergey Konstantinov 2020-12-07 12:32:21 +03:00
parent 5ead108c5d
commit ad738b7466
3 changed files with 2 additions and 2 deletions

View File

@ -849,7 +849,7 @@ GET /orders/statistics
<p><strong>Хорошо</strong>:</p>
<pre><code>// Возвращает агрегированную статистику заказов за указанный период
POST /v1/orders/statistics/aggregate
{ "start_date", "end_date" }
{ "begin_date", "end_date" }
</code></pre>
<p><strong>Стремитесь к тому, чтобы из сигнатуры функции было абсолютно ясно, что она делает, что принимает на вход и что возвращает</strong>. Вообще, при прочтении кода, работающего с вашим API, должно быть сразу понятно, что, собственно, он делает — без подглядывания в документацию.</p>
<p>Два важных следствия:</p>

Binary file not shown.

View File

@ -42,7 +42,7 @@ GET /orders/statistics
```
// Возвращает агрегированную статистику заказов за указанный период
POST /v1/orders/statistics/aggregate
{ "start_date", "end_date" }
{ "begin_date", "end_date" }
```
**Стремитесь к тому, чтобы из сигнатуры функции было абсолютно ясно, что она делает, что принимает на вход и что возвращает**. Вообще, при прочтении кода, работающего с вашим API, должно быть сразу понятно, что, собственно, он делает — без подглядывания в документацию.