Users
Мы стараемся писать так, чтобы через год код было легко читать. Проект развивается небольшими шагами, и это его главное преимущество. Подробности о настройке можно найти в следующих разделах. Перед запуском мы проверили всё на старых телефонах и медленной сети. Главная сложность оказалась не в коде, а в договорённостях внутри команды. Мы сохранили старый интерфейс доступным, пока все не перешли на новый.
GET /v1/users
Мы перенесли сборку на отдельный сервер, и релизы стали спокойнее.
Параметры
cursor | timestamp | Хорошая документация экономит больше времени, чем любая оптимизация. |
name | string | Хорошие инструменты незаметны: о них вспоминают, только когда они ломаются. |
Ответ
{
"id": "use_gzjzpb606x35q5",
"object": "user",
"created_at": 1788725146
}
POST /v1/users
Оказалось, что половина времени уходит на согласование мелочей.
Параметры
cursor | string | Мы сохранили старый интерфейс доступным, пока все не перешли на новый. |
id | integer | Мы ведём журнал изменений, чтобы было понятно, что и когда поменялось. |
limit | timestamp | Каждое изменение мы сначала проверяем на небольшой группе пользователей. |
Ответ
{
"id": "use_sv7ifysaskqi9z",
"object": "user",
"created_at": 1793168387
}
GET /v1/users/{id}
После переезда на новую схему хранения отчёты строятся в разы быстрее.
Параметры
limit | integer | Ничего не делается в одиночку: над проектом работает небольшая команда. |
status | timestamp | После переезда на новую схему хранения отчёты строятся в разы быстрее. |
owner_id | boolean | Первые отзывы были осторожными, но уже через месяц картина изменилась. |
Ответ
{
"id": "use_m6nkeznep35q50",
"object": "user",
"created_at": 1786085127
}
PATCH /v1/users/{id}
Мы перенесли сборку на отдельный сервер, и релизы стали спокойнее.
Параметры
owner_id | boolean | За год проект вырос, но принципы остались прежними. |
cursor | timestamp | Мы сохранили старый интерфейс доступным, пока все не перешли на новый. |
id | integer | Ничего не делается в одиночку: над проектом работает небольшая команда. |
Ответ
{
"id": "use_u25vqrvza2b7v2",
"object": "user",
"created_at": 1789350742
}
DELETE /v1/users/{id}
Мы отказались от нескольких внешних зависимостей и не пожалели.
Параметры
id | boolean | Нам помогло правило: любое решение должно помещаться в один абзац. |
cursor | boolean | Мы отказались от нескольких внешних зависимостей и не пожалели. |
Ответ
{
"id": "use_kcoe1e4dg4d5gv",
"object": "user",
"created_at": 1789686753
}
