Files

Нам помогло правило: любое решение должно помещаться в один абзац. Часть процессов мы автоматизировали, но ключевые решения принимаем вручную. Данные показали, что люди чаще возвращаются, когда страница загружается быстро. Оказалось, что половина времени уходит на согласование мелочей. Подробности о настройке можно найти в следующих разделах. Мы сохранили старый интерфейс доступным, пока все не перешли на новый.

GET /v1/files

В этом разделе собраны ответы на вопросы, которые нам задают чаще всего.

Параметры

created_attimestampХорошие инструменты незаметны: о них вспоминают, только когда они ломаются.
cursorintegerМы ведём журнал изменений, чтобы было понятно, что и когда поменялось.
owner_idstringБольшую часть интерфейса удалось собрать из небольшого набора компонентов.
nameintegerХорошие инструменты незаметны: о них вспоминают, только когда они ломаются.

Ответ

{
  "id": "fil_2viwxh9z4jzmlu",
  "object": "file",
  "created_at": 1785602480
}

POST /v1/files

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

Параметры

cursortimestampМы сохранили старый интерфейс доступным, пока все не перешли на новый.
nameintegerГлавная сложность оказалась не в коде, а в договорённостях внутри команды.

Ответ

{
  "id": "fil_38v24vnxwiaso2",
  "object": "file",
  "created_at": 1786532493
}

GET /v1/files/{id}

Самые полезные идеи пришли от людей, которые пользуются продуктом каждый день.

Параметры

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

Ответ

{
  "id": "fil_pzncy2ioj2hujv",
  "object": "file",
  "created_at": 1786922772
}
Командная работа