GraphQL是一种现代的查询语言,它允许你定义查询的数据结构,并精确地询问你想要的东西,仅此而已。
GraphQL查询不仅可以访问一个资源的属性,还可以顺利地跟踪它们之间的引用。典型的REST API需要从多个URL中加载,而GraphQL API则可以在单个请求中获得您的应用程序所需的所有数据。
查询。READ操作由GraphQL查询执行,这些操作不会改变数据。
突变。你将使用突变来执行所有其他操作来修改数据。
对象类型是一组字段,用于定义你可以从API中查询的数据集。
query {
}
mutation {
}
字段用于询问特定对象的属性。
每个对象都有字段,可以通过名称来查询,以便查询到你需要的属性。
query {
NFTEXToken {
id
}
}
你可以通过传递参数来确定查询的返回值。这可以缩小结果范围,让你只得到你想要的东西。
在下面的例子中,对象是"token",请求的字段是"name",参数是"id"。
query GetToken($name: String) {
token: NFTEXTokens(
name: $name
) {
id
}
}
GraphQL最友好的功能可能是它的可视化界面,这是一个用于编写、验证和测试GraphQL查询的浏览器内工具。
在你查询API之前,建议通过可视化界面运行你的查询,以确保它们是正确的,并且返回的数据是你期望的数据。
您可以使用以下GraphiQL Web界面与可信云进行交互。
您也可以下载GraphiQL桌面版与可信云进行交互。
下载Windows版。 https://www.electronjs.org/apps/graphiql
下面是在桌面应用中使用的端点。
查询是询问数据的方式,它类似于基于REST的API中的GET操作。
以下是可以通过API查询的NFTEX对象类型列表。
GraphQL中的Mutating是修改数据的方式,它是用来包含GET以外的所有非API函数的术语。这包括你可能从基于REST的API中熟悉的PUT、POST和DELETE等函数。
与查询不同,突变需要将所有的参数加入到突变中。运行后,可以查询突变发生后对象的值。
有不同类型的NFTEX对象类型可以通过API进行突变。
以下是可以变异的NFTEX对象类型列表。
你可以在GraphiQL文档资源管理器中找到关于哪些数据可以使用这些对象类型进行查询和突变的综合信息。
要找到它,请进入GraphiQL可视化界面,点击右上角的"文件"按钮。
你可能会注意到,在我们的文档中,我们提供了一些你可以使用的查询和突变的例子,这些例子中通常会包含一些变量。您可以通过简单地通过页面底部的"查询变量"部分的数据来查询这些变量。
只需向上滑动底栏(查询变量),就可以开始输入变量和各自的数据。