AVATA API 最佳实践

💡

前置条件：应用方务必已成功设置好回调地址，并确保该回调地址可正常使用。

步骤1：在调用接口前，先根据业务需求自定义生成项目下唯一的 operation_id，并持久化到本地

注意

您的每一笔上链交易，都应关联一个固定的 operation_id；在调用接口成功后，该交易一定会被处理，请不要更换operation_id调用接口；

使用不同的 operation_id 发起的上链请求，将表示一笔全新的上链交易；

已经被使用过的operation_id，将不会被接口所通过，且提示请求失败 duplicate request, operation_id；

步骤3：当交易成功后，会将交易信息自动推送到您设置的回调地址

信息

您需要做的：

对接收到的交易信息进行验签(确保该本次推送来自于 Avata 平台)。可参考：验签示例；

通过验签后，应用方需自行保存好接收到的消息；

收到回调通知并验签成功后，返回字符串 SUCCESS (区分大小写)

步骤4：如果步骤3在等待一定时间后（一般为10-20s左右）没有收到回调通知，需要通过 查询上链交易结果 接口主动查询交易完成情况。

备注

Avata API 上链请求会产生以下两种交易结果：

成功：HTTP 状态码为 2xx；

失败：HTTP 状态码非 2xx，应用方可根据响应体中的 error message 去 Avata 技术社区查找对应失败原因的说明并执行下一步操作。