Referencia de la API

Documentos

Consultar app.capabilities para comprobar la compatibilidad de funciones y app.access junto con los permisos del anfitrión para la autorización. Los ejemplos usan valores sintéticos; sustituir las rutas, ID, entradas y filtros antes de llamar.

Definiciones de tipos

graphql
type Query {
  docCount(query: String!): Int!
  docExtGroups(query: String! = ""): [DocExtGroup!]!
  docs(query: String!, offset: Int!, limit: Int!, sortBy: DocSortBy!): [Doc!]!
}

enum DataType {
	DEFAULT
	AUDIO
	VIDEO
	IMAGE
	SMS
	CONTACT
	NOTE
	FEED_ENTRY
	CALL
	PACKAGE
	FILE
	APP_FILE
	DOC
}

type Doc implements MediaItem {
	id: ID!
	title: String!
	path: String!
	extension: String!
	size: Long!
	bucketId: ID!
	createdAt: Instant!
	updatedAt: Instant!
	tags: [Tag!]!
}

type DocExtGroup {
	ext: String!
	count: Int!
}

enum DocSortBy {
	UPDATED_AT_ASC
	UPDATED_AT_DESC
	SIZE_ASC
	SIZE_DESC
	NAME_ASC
	NAME_DESC
}

scalar Instant

scalar Long

interface MediaItem {
	id: ID!
	title: String!
	path: String!
	size: Long!
	bucketId: ID!
	createdAt: Instant!
	updatedAt: Instant!
}

type Tag {
	id: ID!
	name: String!
	type: DataType!
	count: Int!
}

Operaciones

query

docCount

Contar los documentos que coincidan con una consulta.

graphql
query docCount($query: String!) {
  docCount(query: $query)
}
query

docExtGroups

Listar todas las extensiones de archivo distintas y sus recuentos. Útil para crear una interfaz de filtrado por tipo.

graphql
query docExtGroups($query: String!) {
  docExtGroups(query: $query) { ext count }
}
query

docs

Buscar documentos. Dejar query vacío para listar todos.

graphql
query docs($query: String!, $offset: Int!, $limit: Int!, $sortBy: DocSortBy!) {
  docs(query: $query, offset: $offset, limit: $limit, sortBy: $sortBy) { id title path extension size bucketId createdAt updatedAt }
}