PlainApp
API 参考

文档

通过 app.capabilities 判断功能支持,通过 app.access 和宿主权限判断访问授权。示例使用合成数据,调用前请替换路径、ID、输入和筛选条件。

类型定义

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!
}

操作

query

docCount

统计符合查询条件的文档数。

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

docExtGroups

列出不重复的文件扩展名及其数量,可用于构建按类型筛选的界面。

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

docs

搜索文档;query 留空时列出全部文档。

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