Users

Мы стараемся писать так, чтобы через год код было легко читать. Проект развивается небольшими шагами, и это его главное преимущество. Подробности о настройке можно найти в следующих разделах. Перед запуском мы проверили всё на старых телефонах и медленной сети. Главная сложность оказалась не в коде, а в договорённостях внутри команды. Мы сохранили старый интерфейс доступным, пока все не перешли на новый.

GET /v1/users

Мы перенесли сборку на отдельный сервер, и релизы стали спокойнее.

Параметры

cursortimestampХорошая документация экономит больше времени, чем любая оптимизация.
namestringХорошие инструменты незаметны: о них вспоминают, только когда они ломаются.

Ответ

{
  "id": "use_gzjzpb606x35q5",
  "object": "user",
  "created_at": 1788725146
}

POST /v1/users

Оказалось, что половина времени уходит на согласование мелочей.

Параметры

cursorstringМы сохранили старый интерфейс доступным, пока все не перешли на новый.
idintegerМы ведём журнал изменений, чтобы было понятно, что и когда поменялось.
limittimestampКаждое изменение мы сначала проверяем на небольшой группе пользователей.

Ответ

{
  "id": "use_sv7ifysaskqi9z",
  "object": "user",
  "created_at": 1793168387
}

GET /v1/users/{id}

После переезда на новую схему хранения отчёты строятся в разы быстрее.

Параметры

limitintegerНичего не делается в одиночку: над проектом работает небольшая команда.
statustimestampПосле переезда на новую схему хранения отчёты строятся в разы быстрее.
owner_idbooleanПервые отзывы были осторожными, но уже через месяц картина изменилась.

Ответ

{
  "id": "use_m6nkeznep35q50",
  "object": "user",
  "created_at": 1786085127
}

PATCH /v1/users/{id}

Мы перенесли сборку на отдельный сервер, и релизы стали спокойнее.

Параметры

owner_idbooleanЗа год проект вырос, но принципы остались прежними.
cursortimestampМы сохранили старый интерфейс доступным, пока все не перешли на новый.
idintegerНичего не делается в одиночку: над проектом работает небольшая команда.

Ответ

{
  "id": "use_u25vqrvza2b7v2",
  "object": "user",
  "created_at": 1789350742
}

DELETE /v1/users/{id}

Мы отказались от нескольких внешних зависимостей и не пожалели.

Параметры

idbooleanНам помогло правило: любое решение должно помещаться в один абзац.
cursorbooleanМы отказались от нескольких внешних зависимостей и не пожалели.

Ответ

{
  "id": "use_kcoe1e4dg4d5gv",
  "object": "user",
  "created_at": 1789686753
}
Командная работа