Încărcare fișier

Încărcare simpla de fișier.

Endpoint

POST /api/v1/uploads

Parametri

Parametri body

Parametru	Tip	Obligatoriu	Descriere
name	string	yes	Numele fișierului, trebuie să fie același pentru toate bucățile.
file	file	yes	Fișierul sau o parte din fișier ca bucată.
extension	string	yes	Extensia fișierului.
path	string	no	Calea către directorul fișierului. Folosește-o când vrei să încarci un folder și să recreezi structura de foldere în backend. Ex.: /Documents/Photos/wallpaper.jpg
parent_id	uuid	no	UUID-ul folderului părinte. Dacă nu este setat, fișierele vor fi încărcate în locația principală.

Exemplu de cerere

cURL

curl --location --request POST 'https://files.ro/api/v1/uploads' \
--header 'Content-Type: multipart/form-data' \
--header 'Authorization: Bearer {token}' \
--form 'name=filesro-hero' \
--form 'file=@/path/to/file' \
--form 'extension=jpg'

Răspuns

201 Created

{
  "data": {
    "id": "file_123",
    "type": "file",
    "attributes": {
      "filesize": "1.2 MB",
      "name": "report.pdf",
      "basename": "report-uuid.pdf",
      "mimetype": "application/pdf",
      "file_url": "https://files.ro/file/report-uuid.pdf",
      "thumbnail": "https://files.ro/thumbnail/report-uuid.jpg",
      "parent_id": "folder_123",
      "created_at": "01. Jan. 2024",
      "updated_at": "02. Jan. 2024",
      "deleted_at": null
    },
    "relationships": {
      "shared": {
        "data": {
          "id": "share_123",
          "type": "shared",
          "attributes": {
            "permission": "editor",
            "protected": false,
            "item_id": "item_123",
            "expire_in": 24,
            "token": "share_token",
            "link": "https://files.ro/share/share_token",
            "type": "folder"
          }
        }
      },
      "parent": {
        "data": {
          "type": "folder",
          "id": "folder_123",
          "attributes": {
            "name": "Projects"
          }
        }
      },
      "creator": {
        "data": {
          "type": "creator",
          "id": "user_123",
          "attributes": {
            "name": "Jane Doe",
            "avatar": "https://files.ro/storage/avatars/jane.png",
            "color": "#00BC7E"
          }
        }
      },
      "exif": {
        "data": {
          "type": "exif",
          "id": "exif_123",
          "attributes": {
            "date_time_original": "2024-01-01",
            "artist": "Jane Doe",
            "height": 1080,
            "width": 1920,
            "x_resolution": "72",
            "y_resolution": "72",
            "color_space": "sRGB",
            "camera": "Canon",
            "model": "EOS",
            "aperture_value": 2.8,
            "exposure_time": "1/125",
            "focal_length": "50mm",
            "iso": 100,
            "aperture_f_number": 2.8,
            "ccd_width": "5.76mm",
            "longitude": "0.0000",
            "latitude": "0.0000"
          }
        }
      }
    }
  }
}

401 Unauthorized

{
  "type": "error",
  "message": "You are not authorized"
}

422 Unprocessable Entity

{
  "message": "The given data was invalid.",
  "errors": {
    "field": [
      "The field is required."
    ]
  }
}