1. Webhook
DeepSafe开发者文档
  • Getting Started
    • 快速开始
    • 创建Api Key
    • 其他说明
    • http请求约定
      • 请求头
      • 请求方法
      • 返回值与错误码
      • Body加密与签名
      • Webhook事件解密与校验
    • Webhook
      • Webhook说明
      • Webhook事件解密与校验
  • Api文档
    • README
    • 钱包
      • 获取钱包列表
      • 获取单个钱包
    • 白名单
      • 获取白名单列表
      • 获取可用的白名单列表
      • 查询白名单转账限制开关状态
    • Schemas
      • wallet
        • list_wallet_resp
        • wallet_base_info
        • get_wallet_resp
        • pending_tx_count
        • wallet_coin_balance
        • wallet_coin_balance_with_price
        • list_wallet_item
      • config
        • coin_info
        • chain_info
        • coin_with_chain
        • whitelist_chain_config
      • sub_wallet
        • sub_wallet_base_info
        • sub_wallet_balance_item
      • whitelist
        • list_whitelist_resp
        • whitelist_with_chain
        • whitelist_tag_info
        • whitelist
        • whitelist_group_info
        • whitelist_transfer_restriction
        • restriction_status_res
      • audit
        • change_whitelist_info
      • base response
      • pageData
  • Webhook文档
    • README
    • 白名单
      • 创建白名单
      • 删除白名单
      • 修改白名单
    • Schemas
      • 白名单
      • base response
      • base event
  • 签名机
    • REAME
    • 对接说明
  1. Webhook

Webhook说明

若需要接收webhook事件,需要你的服务需要实现事件接收接口,我们会加密推送相关事件。

解密后的事件#

数据解密后你会得到下列结构
{
    "type" : "test",
    "data" : {...},
    "event_created_at" : 1784008527111,
    "event_id" : ""
}
type : 事件类型,不同type对应的data结构不同
data : 具体推送的事件
event_created_at : webhook事件的创建时间,毫秒。如果重新推送,这个时间不会变
event_id : 事件唯一id,可以用来去重

返回#

如果处理成功,你应该返回下列response:
{
    "code": 1000
}

推送失败#

如果推送失败或收到的response不符合预期,会在下面时间重试:1分钟后、10分钟后、1小时后、12小时后、24小时后。
若5次重试都失败则不会再重试。

重复推送#

你应该记录event_id,避免重复处理相同的事件
Modified at 2026-07-14 08:13:56
Previous
Webhook事件解密与校验
Next
Webhook事件解密与校验
Built with