访问文件 Accessing Files

example.com/assets/<file-id>
example.com/assets/1ac73658-8b62-4dea-b6da-529fbc9d01a4

<a href="https://your-directus.com/assets/<file-id>?download" target="_blank" download="Your File.pdf">Download</a>

example.com/assets/<file-id>?key=<key>

example.com/assets/<file-id>?fit=<fit>&width=<width>&height=<height>&quality=<quality>
example.com/assets/1ac73658-8b62-4dea-b6da-529fbc9d01a4?fit=cover&width=200&height=200&quality=80

?transforms=[
 ["blur", 45],
 ["tint", "rgb(255, 0, 0)"],
 ["expand", { "right": 200, "bottom": 150 }]
]

{
  "id": "4f4b14fa-a43a-46d0-b7ad-90af5919bebb",
  "storage": "local",
  "filename_disk": "4f4b14fa-a43a-46d0-b7ad-90af5919bebb.jpeg",
  "filename_download": "paulo-silva-vSRgXtQuns8-unsplash.jpg",
  "title": "Paulo Silva (via Unsplash)",
  "type": "image/jpeg",
  "folder": null,
  "uploaded_by": "0bc7b36a-9ba9-4ce0-83f0-0a526f354e07",
  "uploaded_on": "2021-02-04T11:37:41-05:00",
  "modified_by": null,
  "modified_on": "2021-02-04T11:37:42-05:00",
  "filesize": 3442252,
  "width": 3456,
  "height": 5184,
  "duration": null,
  "description": null,
  "location": null,
  "tags": ["photo", "pretty"],
  "metadata": {
    "icc": {
      "version": "2.1",
      "intent": "Perceptual",
      "cmm": "lcms",
      "deviceClass": "Monitor",
      "colorSpace": "RGB",
      "connectionSpace": "XYZ",
      "platform": "Apple",
      "creator": "lcms",
      "description": "c2",
      "copyright": ""
    }
  }
}

GET /files
SEARCH /files

POST /graphql/system

type Query {
 files: [directus_files]
}

query {
 files {
  id
  filename_disk
 }
}

GET /files/:id

GET /files/0fca80c4-d61c-4404-9fd7-6ba86b64154d

POST /graphql/system

type Query {
 files_by_id(id: ID!): directus_files
}

query {
 files_by_id(id: "0fca80c4-d61c-4404-9fd7-6ba86b64154d") {
  id
  filename_disk
 }
}

--__X_BOUNDARY__
Content-Disposition: form-data; name="title"

Example
--__X_BOUNDARY__
Content-Disposition: form-data; name="file"; filename="paulo-silva-vSRgXtQuns8-unsplash.jpg"
Content-Type: image/jpeg

// binary data

--__X_BOUNDARY__
Content-Disposition: form-data; name="title"

Another Title
--__X_BOUNDARY__
Content-Disposition: form-data; name="file"; filename="mae-mu-GFhqNX1gE9E-unsplash.jpg"
Content-Type: image/jpeg

// binary data

import axios from 'axios'

const fileInput = document.querySelector('input[type="file"]')
const formData = new FormData()

formData.append('title', 'My First File')
formData.append('file', fileInput.files[0])

await axios.post('/files', formData)

POST /files

// Request

Content-Type: multipart/form-data; charset=utf-8; boundary=__X_BOUNDARY__
Content-Length: 3442422

--__X_BOUNDARY__
Content-Disposition: form-data; name="file"; filename="paulo-silva-vSRgXtQuns8-unsplash.jpg"
Content-Type: image/jpeg

ÿØÿàJFIF


HHÿâICC_PROFILE

lcmsmntrRGB XYZ Ü
)9acspAPPLöÖ
Ó-lcms
descü^cprt
\wtpt
hbkpt
|rXYZ
gXYZ
¤bXYZ
¸rTRC
Ì@gTRC
Ì@bTRC
Ì@descc2textIXXYZ öÖ
Ó-XYZ 3¤XYZ o¢8õXYZ b™·…ÚXYZ $ „¶ÏcurvË
Éc’kö?Q4!ñ)2;’FQw]íkpz‰±š|¬i¿}ÓÃé0ÿÿÿۄ

POST /files/import

// POST /files/import

{
  "url": "https://source.unsplash.com/random",
  "data": {
    "title": "Example"
  }
}

POST /graphql/system

type Mutation {
 import_file(url: String!, data: create_directus_files_input!): directus_files
}

mutation {
 import_file(url: "https://source.unsplash.com/random", data: { title: "Example" }) {
  id
 }
}

PATCH /files/:id

// PATCH /files/0fca80c4-d61c-4404-9fd7-6ba86b64154d

{
  "title": "Example"
}

POST /graphql/system

type Mutation {
 update_files_item(id: ID!, data: update_directus_files_input!): directus_files
}

mutation {
 update_files_item(id: "0fca80c4-d61c-4404-9fd7-6ba86b64154d", data: { title: "Example" }) {
  id
  title
 }
}

PATCH /files

// PATCH /files

{
  "keys": ["b6123925-2fc0-4a30-9d86-863eafc0a6e7", "d17c10aa-0bad-4864-9296-84f522c753e5"],
  "data": {
    "tags": ["cities"]
  }
}

POST /graphql/system

type Mutation {
 update_files_items(ids: [ID!]!, data: update_directus_files!): [directus_files]
}

mutation {
 update_files_items(
  ids: ["b6123925-2fc0-4a30-9d86-863eafc0a6e7", "d17c10aa-0bad-4864-9296-84f522c753e5"]
  data: { tags: ["cities"] }
 )
}

DELETE /files/:id

DELETE /files/0fca80c4-d61c-4404-9fd7-6ba86b64154d

POST /graphql/system

type Mutation {
 delete_files_item(id: ID!): delete_one
}

mutation {
 delete_files_item(id: "0fca80c4-d61c-4404-9fd7-6ba86b64154d") {
  id
 }
}

DELETE /files

// DELETE /files

["d17c10aa-0bad-4864-9296-84f522c753e5", "b6123925-2fc0-4a30-9d86-863eafc0a6e7"]

POST /graphql/system

type Mutation {
 delete_files_items(ids: [ID!]!): delete_many
}

mutation {
 delete_files_items(ids: ["d17c10aa-0bad-4864-9296-84f522c753e5", "b6123925-2fc0-4a30-9d86-863eafc0a6e7"]) {
  ids
 }
}