Files
Подробности о настройке можно найти в следующих разделах. За год проект вырос, но принципы остались прежними. Хорошая документация экономит больше времени, чем любая оптимизация.
GET /v1/files
Главная сложность оказалась не в коде, а в договорённостях внутри команды.
Параметры
status | boolean | Данные показали, что люди чаще возвращаются, когда страница загружается быстро. |
created_at | boolean | Важно заранее договориться, какие метрики считать успехом. |
Ответ
{
"id": "fil_mytj6exxoknltm",
"object": "file",
"created_at": 1794423748
}
POST /v1/files
Мы отказались от нескольких внешних зависимостей и не пожалели.
Параметры
cursor | integer | Хорошие инструменты незаметны: о них вспоминают, только когда они ломаются. |
limit | timestamp | Мы благодарны всем, кто присылал замечания и предложения. |
owner_id | boolean | Тесты не гарантируют отсутствие ошибок, но заметно снижают их цену. |
include | integer | Мы начали с простого прототипа и постепенно довели его до рабочей версии. |
id | string | Проще всего начать с примера и менять его под свою задачу. |
Ответ
{
"id": "fil_ih0j8e07hebl86",
"object": "file",
"created_at": 1789594648
}
GET /v1/files/{id}
Проект развивается небольшими шагами, и это его главное преимущество.
Параметры
owner_id | integer | Если что-то работает не так, как описано, напишите нам — мы поправим текст. |
id | boolean | В этом разделе собраны ответы на вопросы, которые нам задают чаще всего. |
name | integer | Хороший макет начинается с текста, а не с картинок. |
Ответ
{
"id": "fil_xm2llkcazyzwwm",
"object": "file",
"created_at": 1785965736
}
PATCH /v1/files/{id}
Данные показали, что люди чаще возвращаются, когда страница загружается быстро.
Параметры
created_at | string | Часть процессов мы автоматизировали, но ключевые решения принимаем вручную. |
cursor | string | Ничего не делается в одиночку: над проектом работает небольшая команда. |
status | boolean | Подробности о настройке можно найти в следующих разделах. |
include | boolean | Самые полезные идеи пришли от людей, которые пользуются продуктом каждый день. |
Ответ
{
"id": "fil_me6qdqc934cflp",
"object": "file",
"created_at": 1785960171
}
DELETE /v1/files/{id}
Мы сохранили старый интерфейс доступным, пока все не перешли на новый.
Параметры
limit | boolean | За год проект вырос, но принципы остались прежними. |
id | integer | Пользователи редко читают инструкции, поэтому подсказки должны быть короткими. |
owner_id | timestamp | Важно заранее договориться, какие метрики считать успехом. |
Ответ
{
"id": "fil_dc7ljxxx6kysa4",
"object": "file",
"created_at": 1790050086
}