经销商 API 信息 - ChimeraTool 帮助

您可以使用我们的 PHP 类与 chimeratool.com.cn 服务器通信：转移信用、撤销信用转移、收集有关您的帐户的信息（例如您的信用余额）、列出您的转移并识别 chimeratool 用户。

我们的 PHP 类通过 HTTPS 协议进行通信并使用 GET 方法以 JSON 格式检索数据。

您可以在此处下载 PHP 调用。

错误代码和消息

API 调用可以响应不同的错误代码，因此您可以轻松识别错误。

连接错误

身份验证错误

传输错误

列出错误

撤销错误

检查用户错误

检查 ChimeraCard 错误

检查用户许可证错误

销售许可证错误

扩展许可证错误

升级许可证错误

吊销执照错误

API 函数

所有函数都返回一个关联数组，该数组始终包含一个名为“success”的布尔类型元素。如果其值为 FALSE，则 API 调用失败，您也可以在响应数组中找到“code”和“message”键。“code”和“message”元素描述错误。错误代码列在上面。

在没有错误的情况下，可能会有各种响应。下面的列表解释了每个函数及其参数和返回值。返回值列表表示返回的关联数组的键。

ChimeraApi::getTransferList($page = 1, $limit = 50)

您可以使用此方法查询/列出您的交易。您可以获取要撤销的交易的 ID。生成的列表按日期降序排列。

参数：

• $page - 结果集的页面（第一页是 1）
• $limit - 每页结果数（不能大于 200）

它就像一个标准的分页功能。如果您有 500 笔交易，并且 $limit 设置为 50，那么第一页将显示交易 1-50 的结果，第二页将显示交易 51-100。

返回：

• 成功-表示调用是否成功（布尔值）
• 转账 - 信用转账清单（关联数组）
  • id - 转账ID（int）
  • date - 传输日期（关联数组，序列化的 DateTime 对象）
  • 来自 - 信用来源的用户名（字符串）
  • 收件人 - 积分发送至的用户姓名（字符串）
  • amount - 转入信用额度（十进制）
  • 已撤销 - 表示交易已被撤销（布尔值）

ChimeraApi::获取信息()

提供有关您的帐户的信息。

参数： -

返回：

• 成功 - 表示调用是否成功（布尔值）
• creditBalance - 您当前的信用余额
• transfersCount - 您的信用转账次数

ChimeraApi::transferCredit($userId，$amount)

将“$amount”信用额度从您的账户转移到“$userId”。

参数：

• $userId - 您要向其发送信用的用户的 ID
• $amount - 您想要转移的学分数

返回：

• 成功-表示调用是否成功（布尔值）

• transferId - 信用转账的 ID（整数）

• 消息 - 人类可读的成功消息

ChimeraApi::revokeTransfer($transferId)

撤销由“$transferId”标识的转移。

参数：

• $transferId - 您想要撤销的信用转账的 ID（从 transferCredit 获取）

返回：

• 成功-表示调用是否成功（布尔值）
• 消息 - 人类可读的成功消息

ChimeraApi::checkUser($用户名，$邮箱)

您可以用此功能验证用户。它会以给定用户的 ID 进行响应。

参数：

• $username——用户名称

返回：

• 成功 - 表示调用是否成功（布尔值）
• userId - 指定用户的 ID

ChimeraApi::checkChimeraCard($serialnumber)

您可以使用此功能验证 ChimeraCard。

参数：

• $serialnumber - 卡的序列号

返回：

• 成功 - 表示调用是否成功（布尔值）
• serialnumber - ChimeraCard 的序列号（字符串）
• haslicence - 表示 ChimeraCard 是否具有许可证（布尔值）
• licencename - 如果 ChimeraCard 有许可证，则许可证名称（字符串）在这里，否则为 null

ChimeraApi::checkUserLicences（$用户名，$电子邮件）

检查用户的许可证。

参数：

• $username——用户名称

返回：

• 成功 - 表示调用是否成功（布尔值）
• userId - 指定用户的 ID
• licence——用户的许可证（数组）

ChimeraApi::sellLicence（$targetid，$targettype，$licencename）

出售许可证。

参数：

• $targetid - 目标的 id（用户 ID 或 ChimeraCard 序列号）
• $targettype - 'user' 或 'chimeracard'
• $licencename – 许可证名称

返回：

• 成功 - 表示调用是否成功（布尔值）

• actionId - 经销商操作的 ID（整数）

ChimeraApi::extendLicence($userlicenceid)

延长许可证。

参数：

• $userlicenceid - 用户许可证的 ID

返回：

• 成功 - 表示调用是否成功（布尔值）

ChimeraApi::upgradeLicence($userlicenceid，$licencename = 'Pro')

升级许可证。

参数：

• $userlicenceid - 用户许可证的 ID
• $licencename - 'Pro' 或 'Premium'，默认为 'Pro'（可选）

返回：

• 成功 - 表示调用是否成功（布尔值）

ChimeraApi::availableLicences()

列出可用的许可证

参数：

• -

返回：

• licence - 可用许可证（数组）

ChimeraApi::buyLicencePrices($userId)

计算用户的许可证价格

参数：

• $用户ID

返回：

• licence - 可用许可证（数组）

ChimeraApi::getSoldLicenceList($page，$limit)

返回已售许可证列表

参数：

• $page – 页码
• $limit – 每页结果数

返回：

• 成功
• 已售许可证 - （数组）
• 分页 - 分页信息

ChimeraApi::revokeLicence($actionId)

撤销已售出的许可证（如果可能）

参数：

• $actionId - 操作的 ID（从 sellLicence 和 getSoldLicenceList 获取）

返回：

• 成功