Partajeaza element

Partajeaza public un fișier sau folder.

Endpoint

POST /api/v1/share

Parametri

Parametri body

Parametru	Tip	Obligatoriu	Descriere
id	uuid	yes	ID-ul elementului pe care vrei să îl partajezi.
isPassword	boolean	-	Determină dacă folderul este partajat public sau protejat privat cu parolă.
password	string	obligatoriu când ispassword:yes	Parola care protejează conținutul din folder.
type	string	yes	Tipul elementului redenumit. Tipuri permise: folder sau file.
permission	string	obligatoriu când este folder	Permisiunile de editare pentru folder. Tipuri permise: editor sau visitor.
expiration	integer	-	Timpul în ore după care linkul expiră automat.
emails	array	-	Lista de adrese de email valide.

Exemplu de cerere

cURL

curl --location --request POST 'https://files.ro/api/v1/share' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data-raw '{
  "id": "{item_id}",
  "isPassword": true,
  "password": "secret_password",
  "type": "folder",
  "permission": "editor",
  "expiration": 1,
  "emails": [
    "jane@doe.com"
  ]
}'

Răspuns

201 Created

{
  "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"
    }
  }
}

422 Unprocessable Entity

{
  "type": "error",
  "message": "The item is currently shared."
}

422 Unprocessable Entity

{
  "type": "error",
  "message": "The permission field for folder is required."
}

403 Forbidden

{
  "message": "This action is unauthorized."
}