menu

上链流程类接口

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

在宇链云,无论你上链的动作属于哪种具体的业务或场景,都可以通过相同的接口上链,大大降低了对接成本。

进行各类上链流程可以分为 2 个步骤:

  1. 提交上链动作:通过调用 “批量上链接口”,可以提交一个或多个上链动作;无论你要执行的动作是哪一个,上链的接口都是相同的。
  2. 确认上链结果:通过调用 “获取链上 ID 接口”,可以判断上链的结果。

请注意:

  1. 本能力为异步上链。当你调用上链接口成功后,代表系统已经将该请求插入到上链队列中。一般情况下可以秒级完成上链,但根据不同的请求类型,可能需要 1 秒至数分钟的时间确认上链最终结果。如果网络问题造成上链失败,或者出现排队,宇链云会不断尝试,直到成功为止。
  2. 当你调用接口并得到成功或 pending 状态的返回值后,后续“确认上链结果”失败的可能性极低,因此你可以先告诉用户已成功提交,并在后台刷新状态。
  3. 任何上链成功的数据都会产生对应的 “链上 ID”,这个 id 可以用系统提供的 fetchOnChainIds 查询接口得到。使用该链上 ID 可以方便在区块链浏览器上查询数据。

请先阅读上链及查询相关接口了解如何提交上链后,再根据你具体的业务场景,阅读对应的上链动作的详细说明页面。