menu

可信积分相关接口

更新时间: 2019-12-24 18:10:38 · 编辑者:宇链科技

查询可信积分余额

查询某种可信积分在某个用户 ID 的余额。

接口地址

GET https://v1.api.tc.vastchain.ltd/fungible-token/balance

本请求需要携带签名。请参考 API 签名算法

请求参数

GET 内容请使用 Query 来传递参数和签名。

请求例子及解释:

GET /fungible-token/balance?_appid=9zdo&tokenId=fungible-test&userAppId=9zdo&tokenAppId=9zdo&userId=user1&_t=1565447361023&_s=d6c4f20d0ae5a976c679b5a85138626201b88403332d16dbbb540fb2d62d6a6e

其中:

  • _appId 是发起请求的 appId
  • tokenAppId 是该可信积分发行时所隶属的 appId
  • tokenId 是创建的可信积分的 id
  • userAppId 要查询用户余额的用户所在的 appId
  • userId 是该用户在所属的 appId 中的 id(即开发者在自己业务系统中的用户 id;该 id 无需事先在宇链云上注册或使用过);

响应

{
  "status": "success",
  "version": "1",
  "data": {
      "balance": "32.00000"
  }
}

其中,balance 即为查询到的余额。

必须先检查 status,如果 status 不是 success,则该请求无效,请参考返回值中的错误信息进行排查。

生成可信积分扣款二维码(everiPay)

生成某个用户在某种可信积分扣款的二维码。该二维码的有效期为 20 秒,再加上可能的时间误差,请每 5 秒请求并生成一个新的二维码,并在界面上刷新。

本接口并不负责生成二维码图片,只返回二维码的内容。请自行调用相关库将该二维码渲染出来。

接口地址

GET https://v1.api.tc.vastchain.ltd/fungible-token/everiPay

本请求需要携带签名。请参考 API 签名算法

请求参数

GET 内容请使用 Query 来传递参数和签名。

请求例子及解释:

GET /fungible-token/everiPay?_appid=9zdo&tokenId=fungible-test&userAppId=9zdo&tokenAppId=9zdo&userId=user1&maxAmount=200&_t=1565447361023&_s=d6c4f20d0ae5a976c679b5a85138626201b88403332d16dbbb540fb2d62d6a6e&uuid=a7ab5a851cf38626201b884b332d16db

其中:

  • _appId 是发起请求的 appId
  • tokenAppId 是该可信积分发行时所隶属的 appId
  • tokenId 是创建的可信积分的 id
  • userAppId 要查询用户余额的用户所在的 appId
  • userId 是该用户在所属的 appId 中的 id(即开发者在自己业务系统中的用户 id;该 id 无需事先在宇链云上注册或使用过);
  • maxAmount 为本二维码可扣款的最大积分单位。超过该单位数量的金额,则扣款将一定失败。
  • uuid 当前付款码链上id,纯随机的32位数字和字母,对同一笔支付应该是不变的

响应

{
  "status": "success",
  "version": "1",
  "data": {
    "evtLinks": [
      "https://evt.li/0UKD*AQ+9+QSLJRML10AI:NZK2403152ZPE/:*G/YYUGAIO0K_QS:2*B*$PS:V-J6P5:6CX4SE*QPELS7IPSC7ACFN9ASO*DGG4HLX6/K5J26*ITXG7T6RIN1-:4TU7:XXQHV5CDKDAW3C6O+*"
    ]
  }
}

其中,evtLinks 即为查询到的余额,目前每次只返回一组结果,因此数组中只有一项。

必须先检查 status,如果 status 不是 success,则该请求无效,请参考返回值中的错误信息进行排查。