GraphQL是一种现代的查询语言，它允许你定义查询的数据结构，并精确地询问你想要的东西，仅此而已。

GraphQL查询不仅可以访问一个资源的属性，还可以顺利地跟踪它们之间的引用。典型的REST API需要从多个URL中加载，而GraphQL API则可以在单个请求中获得您的应用程序所需的所有数据。

业务

查询。READ操作由GraphQL查询执行，这些操作不会改变数据。

突变。你将使用突变来执行所有其他操作来修改数据。

对象类型

对象类型是一组字段，用于定义你可以从API中查询的数据集。

‍

GraphQL

query {
}

mutation {
}

‍

领域

字段用于询问特定对象的属性。

每个对象都有字段，可以通过名称来查询，以便查询到你需要的属性。

‍

GraphQL

query {
NFTEXToken {
id
}
}

论据

你可以通过传递参数来确定查询的返回值。这可以缩小结果范围，让你只得到你想要的东西。

在下面的例子中，对象是"token"，请求的字段是"name"，参数是"id"。

‍

GraphQL

query GetToken($name: String) {
token: NFTEXTokens(
name: $name
) {
id
}
}

GraphiQL。GraphiQL的可视化界面

GraphQL最友好的功能可能是它的可视化界面，这是一个用于编写、验证和测试GraphQL查询的浏览器内工具。

在你查询API之前，建议通过可视化界面运行你的查询，以确保它们是正确的，并且返回的数据是你期望的数据。

您可以使用以下GraphiQL Web界面与可信云进行交互。

• 科凡(Testnet)可信云(GraphiQL)：https://kovan.cloud.enjin.io/graphiql。
• Ethereum(Mainnet)可信云(GraphiQL)：https://cloud.enjin.io/graphiql。

GraphiQL桌面应用

您也可以下载GraphiQL桌面版与可信云进行交互。

下载Windows版。 https://www.electronjs.org/apps/graphiql

下面是在桌面应用中使用的端点。

• Kovan (Testnet)GraphiQL端点：https://kovan.cloud.enjin.io/graphql。
• Ethereum（Mainnet）GraphiQL端点：https://cloud.enjin.io/graphql。

NFTEX对象类型的查询

查询是询问数据的方式，它类似于基于REST的API中的GET操作。

以下是可以通过API查询的NFTEX对象类型列表。

• NFTEXApp。使用此查询功能，可获得NFTEX平台上某一应用的信息。
• NFTEXApps。使用该查询功能可获得NFTEX平台上多个应用程序的信息。
• NFTEXBalances。使用该查询获取NFTEX平台上存储的余额信息。
• NFTEXIdentities。使用该查询获取存储在NFTEX平台上的身份信息。
• NFTEXIdentity。用户在游戏中的身份
• NFTEXOauth：使用该查询来登录用户并获取oAuth访问令牌。
• NFTEXPlatform:使用该查询功能可获得NFTEX平台上的项目信息。
• NFTEXTokenEvents。用于查询NFTEX平台记录的令牌事件。
• NFTEXToken。用这个查询来获取令牌数据。
• NFTEXTransactions。用来查询交易请求。
• NFTEXUser：使用该查询获取NFTEX平台上的用户信息。
• NFTEXUsers:用于查询NFTEX平台上的用户数据。
• NFTEXWallet。用这个查询来获取钱包数据。

变更NFTEX对象类型

GraphQL中的Mutating是修改数据的方式，它是用来包含GET以外的所有非API函数的术语。这包括你可能从基于REST的API中熟悉的PUT、POST和DELETE等函数。

与查询不同，突变需要将所有的参数加入到突变中。运行后，可以查询突变发生后对象的值。

有不同类型的NFTEX对象类型可以通过API进行突变。

以下是可以变异的NFTEX对象类型列表。

• 创建NFTEXApp。该突变允许你在NFTEX平台上创建一个新项目。
• 更新NFTEXApp。这个突变允许你更新项目的细节，比如名称或图片。
• 删除NFTEXApp。该突变允许您从NFTEX平台上删除一个项目。这只能由项目创建者执行。
• 创建NFTEXIdentity。该突变允许您在NFTEX平台上为用户创建一个新的身份。
• 更新NFTEXIdentity。这个突变可以让你更新一个身份。此突变也用于将钱包与签名信息联系起来。
• 删除NFTEXIdentity。此突变允许您从NFTEX平台上删除一个身份。您也可以使用此突变来解除钱包中的身份链接。
• 创建NFTEXRequest。这个突变可以让你创建一个新的交易请求发送到区块链上，是与不同智能合约方法交互的主要方式。在创建交易请求时，使用正确的Identity ID很重要，因为存储在上面的ethereum地址将被用作请求的"创建者"，因此需要与被操作的代币的创建者或所有者相匹配。在创建请求的情况下，ID将成为新代币的"创建者"。
• 更新NFTEXRequest。这个突变可以让你更新一个尚未签署的交易请求 并广播到区块链上。
• 删除NFTEXRequest。这个突变可以让你取消一个还没有被签署并广播到区块链上的交易请求。
• 创建NFTEXUser：该突变允许您在NFTEX平台上为您的应用程序创建一个播放器。
• UnlinkApp。这个突变允许你从项目中解开一个钱包的链接。
• UnlinkIdentity。这个突变可以让你解除钱包与身份的链接。
• InvalidateTokenMetadata。瞬间使令牌的元数据无效。

你可以在GraphiQL文档资源管理器中找到关于哪些数据可以使用这些对象类型进行查询和突变的综合信息。

要找到它，请进入GraphiQL可视化界面，点击右上角的"文件"按钮。

查询变量

你可能会注意到，在我们的文档中，我们提供了一些你可以使用的查询和突变的例子，这些例子中通常会包含一些变量。您可以通过简单地通过页面底部的"查询变量"部分的数据来查询这些变量。

只需向上滑动底栏（查询变量），就可以开始输入变量和各自的数据。

‍

‍