Files
Нам помогло правило: любое решение должно помещаться в один абзац. Часть процессов мы автоматизировали, но ключевые решения принимаем вручную. Данные показали, что люди чаще возвращаются, когда страница загружается быстро. Оказалось, что половина времени уходит на согласование мелочей. Подробности о настройке можно найти в следующих разделах. Мы сохранили старый интерфейс доступным, пока все не перешли на новый.
GET /v1/files
В этом разделе собраны ответы на вопросы, которые нам задают чаще всего.
Параметры
created_at | timestamp | Хорошие инструменты незаметны: о них вспоминают, только когда они ломаются. |
cursor | integer | Мы ведём журнал изменений, чтобы было понятно, что и когда поменялось. |
owner_id | string | Большую часть интерфейса удалось собрать из небольшого набора компонентов. |
name | integer | Хорошие инструменты незаметны: о них вспоминают, только когда они ломаются. |
Ответ
{
"id": "fil_2viwxh9z4jzmlu",
"object": "file",
"created_at": 1785602480
}
POST /v1/files
Хорошие инструменты незаметны: о них вспоминают, только когда они ломаются.
Параметры
cursor | timestamp | Мы сохранили старый интерфейс доступным, пока все не перешли на новый. |
name | integer | Главная сложность оказалась не в коде, а в договорённостях внутри команды. |
Ответ
{
"id": "fil_38v24vnxwiaso2",
"object": "file",
"created_at": 1786532493
}
GET /v1/files/{id}
Самые полезные идеи пришли от людей, которые пользуются продуктом каждый день.
Параметры
status | timestamp | Проще всего начать с примера и менять его под свою задачу. |
cursor | string | Первые отзывы были осторожными, но уже через месяц картина изменилась. |
Ответ
{
"id": "fil_pzncy2ioj2hujv",
"object": "file",
"created_at": 1786922772
}
