Creeaza cerere de fișiere

Creeaza o cerere de fișiere noua.

Endpoint

POST /api/v1/requests

Parametri

Parametri body

Parametru	Tip	Obligatoriu	Descriere
email	string	yes	Adresa de email la care se trimite linkul pentru cererea de încărcare.
notes	string	yes	Notițele pentru destinatarul cererii de încărcare.
folder_id	string	yes	ID-ul folderului părinte în care va fi creat folderul cererii de încărcare. Dacă nu este setat, folderul cu fișiere încărcate va fi creat în directorul principal.
name	string	yes	Numele folderului care va fi creat după ce cererea de încărcare este completată.

Exemplu de cerere

cURL

curl --location --request POST 'https://files.ro/api/v1/requests' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data-raw '{
  "email": "jane@doe.com",
  "notes": "Please send me any files!",
  "folder_id": "",
  "name": "My Upload Request"
}'

Răspuns

201 Created

{
  "data": {
    "id": "req_123",
    "type": "upload-request",
    "attributes": {
      "folder_id": "folder_123",
      "status": "open",
      "email": "user@example.com",
      "notes": "Please upload invoices"
    },
    "relationships": {
      "folder": {
        "data": {
          "id": "folder_123",
          "type": "folder",
          "attributes": {
            "name": "Projects",
            "color": "#00BC7E",
            "emoji": null,
            "filesize": 12345678,
            "isTeamFolder": false,
            "items": 12,
            "trashed_items": 0,
            "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_root",
                "attributes": {
                  "name": "Root"
                }
              }
            },
            "user": {
              "data": {
                "type": "user",
                "id": "user_123",
                "attributes": {
                  "name": "Jane Doe",
                  "avatar": "https://files.ro/storage/avatars/jane.png",
                  "color": "#00BC7E"
                }
              }
            }
          }
        }
      },
      "user": {
        "data": {
          "id": "user_123",
          "type": "user",
          "attributes": {
            "name": "Jane",
            "color": "#00BC7E",
            "avatar": "https://files.ro/storage/avatars/jane.png"
          }
        }
      }
    }
  }
}

401 Unauthorized

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

403 Forbidden

{
  "type": "error",
  "message": "Access Denied"
}

422 Unprocessable Entity

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