Exports

Первые отзывы были осторожными, но уже через месяц картина изменилась. Мы стараемся писать так, чтобы через год код было легко читать. Данные показали, что люди чаще возвращаются, когда страница загружается быстро. Каждую неделю мы разбираем одну проблему и записываем выводы.

GET /v1/exports

Данные показали, что люди чаще возвращаются, когда страница загружается быстро.

Параметры

namebooleanМы ведём журнал изменений, чтобы было понятно, что и когда поменялось.
created_atbooleanЧасть процессов мы автоматизировали, но ключевые решения принимаем вручную.
limitstringГлавная сложность оказалась не в коде, а в договорённостях внутри команды.

Ответ

{
  "id": "exp_bqymn323qnw7e2",
  "object": "export",
  "created_at": 1785696801
}

POST /v1/exports

Проект развивается небольшими шагами, и это его главное преимущество.

Параметры

created_atstringДизайн-система выросла из пары страниц заметок в полноценный справочник.
owner_idtimestampМы используем открытые форматы, чтобы данные можно было забрать в любой момент.
cursorstringПроще всего начать с примера и менять его под свою задачу.
nameintegerОказалось, что половина времени уходит на согласование мелочей.

Ответ

{
  "id": "exp_stjv3sk2k3j8z2",
  "object": "export",
  "created_at": 1787014917
}

GET /v1/exports/{id}

Часть процессов мы автоматизировали, но ключевые решения принимаем вручную.

Параметры

idtimestampИногда лучшее решение — убрать лишнее, а не добавить новое.
includetimestampХорошая документация экономит больше времени, чем любая оптимизация.
cursorbooleanХорошая документация экономит больше времени, чем любая оптимизация.
created_atbooleanМы обновляем материалы по мере выхода новых версий.

Ответ

{
  "id": "exp_rw59dswy3apwx4",
  "object": "export",
  "created_at": 1790609389
}

PATCH /v1/exports/{id}

Тесты не гарантируют отсутствие ошибок, но заметно снижают их цену.

Параметры

cursorbooleanНам помогло правило: любое решение должно помещаться в один абзац.
includetimestampМы сохранили старый интерфейс доступным, пока все не перешли на новый.
nametimestampНам помогло правило: любое решение должно помещаться в один абзац.
statusbooleanГлавная сложность оказалась не в коде, а в договорённостях внутри команды.

Ответ

{
  "id": "exp_tyqvvzi919j7nz",
  "object": "export",
  "created_at": 1791410370
}

DELETE /v1/exports/{id}

Мы благодарны всем, кто присылал замечания и предложения.

Параметры

statusstringБольшую часть интерфейса удалось собрать из небольшого набора компонентов.
nametimestampСамые полезные идеи пришли от людей, которые пользуются продуктом каждый день.
idstringПосле переезда на новую схему хранения отчёты строятся в разы быстрее.
created_atbooleanПользователи редко читают инструкции, поэтому подсказки должны быть короткими.
owner_idintegerКаждое изменение мы сначала проверяем на небольшой группе пользователей.

Ответ

{
  "id": "exp_ygo5vxlu1oyl5g",
  "object": "export",
  "created_at": 1790185888
}
Безопасность