Загрузка файла
Загружает файл в систему с автоматической дедупликацией.
Если файл с таким же содержимым уже существует в системе, будет возвращен существующий файл вместо создания дубликата.
Максимальный размер файла — 100 MB.
Request
POST
https://api.kit.yandex.net/v1/files
Body
multipart/form-data
{
"file": "example"
}
|
Name |
Description |
|
file |
Type: string<binary> Файл для загрузки. Example: |
Responses
201 Created
Файл успешно загружен.
Body
application/json
{
"id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
"type": "IMAGE",
"url": "https://example.com/files/550e8400-e29b-41d4-a716-446655440000.png"
}
|
Name |
Description |
|
id |
Type: FileID Идентификатор файла. Example: |
|
type |
Type: FileType Тип файла. Enum: |
|
url |
Type: string<uri> Публичный URL для доступа к файлу. Example: |
FileID
Идентификатор файла.
Type: string<uuid>
Example: 019b30d4-3e28-7a98-ae46-cb66932d1936
FileType
Тип файла.
Type: string
Enum: IMAGE, VIDEO, OTHER
400 Bad Request
Некорректный запрос.
Body
application/json
{
"code": "VALIDATION_ERROR",
"message": "Invalid input",
"trace_id": "00000000000000000000000000000000"
}
|
Name |
Description |
|
code |
Type: string Example: |
|
message |
Type: string Example: |
|
trace_id |
Type: string Уникальный идентификатор запроса для отладки. Example: |
401 Unauthorized
Не авторизован.
Body
application/json
{
"code": "VALIDATION_ERROR",
"message": "Invalid input",
"trace_id": "00000000000000000000000000000000"
}
|
Name |
Description |
|
code |
Type: string Example: |
|
message |
Type: string Example: |
|
trace_id |
Type: string Уникальный идентификатор запроса для отладки. Example: |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
application/json
{
"code": "VALIDATION_ERROR",
"message": "Invalid input",
"trace_id": "00000000000000000000000000000000"
}
|
Name |
Description |
|
code |
Type: string Example: |
|
message |
Type: string Example: |
|
trace_id |
Type: string Уникальный идентификатор запроса для отладки. Example: |