File

Files can be queried by using the "fairuFile" query. The only parameter the query provides is the UUID of the image. For this query no authentication is required.

Query

query GetFairuFile {
  fairuFile(id: "9dff990d-4430-46fc-a5a2-ff666f49d3de") {
    id
    name
    width
    height
    original_width
    original_height
    copyrights {
      name
    }
    licenses {
      name
    }
    caption
    blurhash
    blocked
    alt
    mime
    url(width: 300, height: 300, withStoredFocalPoint: true)
  }
}

Returned types

type FairuAsset @key(fields: "id") {
  id: String
  name: String
  width: Int
  height: Int
  original_width: Int
  original_height: Int
  copyrights: FairuCopyright
  licenses: FairuLicense
  caption: String
  blurhash: String
  blocked: Boolean
  alt: String
  mime: String
  url: String
}
 
type FairuCopyright @key(fields: "id") {
  id: ID!
  name: String
}
 
type FairuLicense @key(fields: "id") {
  id: ID!
  name: String
}

If you are familiar with entities in GraphQL you can make use of our service by integrating our service into your router. But be aware that requests might be rate limited in the future. In this particular case you just need to make sure that your service stores and provides the id of the asset and the type "FairuAsset". The router logic for example of Apollo Router/Gateway will take care of the rest.

File

Query

Returned types

Advanced

On this page