Tresam

Files

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

GET /v1/files

Главная сложность оказалась не в коде, а в договорённостях внутри команды.

Параметры

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

Ответ

{
  "id": "fil_mytj6exxoknltm",
  "object": "file",
  "created_at": 1794423748
}

POST /v1/files

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

Параметры

cursorintegerХорошие инструменты незаметны: о них вспоминают, только когда они ломаются.
limittimestampМы благодарны всем, кто присылал замечания и предложения.
owner_idbooleanТесты не гарантируют отсутствие ошибок, но заметно снижают их цену.
includeintegerМы начали с простого прототипа и постепенно довели его до рабочей версии.
idstringПроще всего начать с примера и менять его под свою задачу.

Ответ

{
  "id": "fil_ih0j8e07hebl86",
  "object": "file",
  "created_at": 1789594648
}

GET /v1/files/{id}

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

Параметры

owner_idintegerЕсли что-то работает не так, как описано, напишите нам — мы поправим текст.
idbooleanВ этом разделе собраны ответы на вопросы, которые нам задают чаще всего.
nameintegerХороший макет начинается с текста, а не с картинок.

Ответ

{
  "id": "fil_xm2llkcazyzwwm",
  "object": "file",
  "created_at": 1785965736
}

PATCH /v1/files/{id}

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

Параметры

created_atstringЧасть процессов мы автоматизировали, но ключевые решения принимаем вручную.
cursorstringНичего не делается в одиночку: над проектом работает небольшая команда.
statusbooleanПодробности о настройке можно найти в следующих разделах.
includebooleanСамые полезные идеи пришли от людей, которые пользуются продуктом каждый день.

Ответ

{
  "id": "fil_me6qdqc934cflp",
  "object": "file",
  "created_at": 1785960171
}

DELETE /v1/files/{id}

Мы сохранили старый интерфейс доступным, пока все не перешли на новый.

Параметры

limitbooleanЗа год проект вырос, но принципы остались прежними.
idintegerПользователи редко читают инструкции, поэтому подсказки должны быть короткими.
owner_idtimestampВажно заранее договориться, какие метрики считать успехом.

Ответ

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