跳到主要内容

第三方与DeBox集成手册

Docs Version Dropdown

欢迎加入技术支持群：点击加入​

第三方系统，与DeBox进行集成时，会遇到注册、登录、积分和NFT获取以及变现、邀请分享等，下面将给出解决方案，解决方案只是解决问题的大思路，细节需要开发者自行把握。

一、关于注册登录：​

第三方系统运行在DeBox内置浏览器​

1、可以可视化授权登录

授权登录第三方系统流程如下：
1.1、客户端拉起登录授权页面；

https://app.debox.pro/oauth/authorize/?app_id=oh...eJ0&
grant_type=authorization_code&scope=userinfo&response_type=code&pay_info=loginTest&
redirect_uri=https://docs.debox.pro/demo/a.html

1.2、用户同意，点击【授权】按钮；
1.3、App重定向到redirect_url?code=xxx ，并将临时票据code传递给第三方系统；
1.4、第三方服务器通过code调用/openapi/oauth2/access_token接口获得access_token；

  curl --location --request GET
  https://open.debox.pro/openapi/oauth2/access_token?
  grant_type=authorization_code&code=ZDY5ZTA......FRE5
  &app_id=xxxxxx&app_secret=xxxxxx&user_id=xxxxxx

1.5、第三方通过access_token和user_id调用/openapi/user/info接口获得用户name、avatar、wallet_address信息。

curl --location --request POST 'https://open.debox.pro/openapi/user/info?user_id=lx....' \
--header 'access_token: eyJhxxCJ9.eyxxJ9.hWxxQ'

1.6、第三方根据user_id或者wallet_address判断自己系统有无此用户:
• 用户不存在，则根据上面获得的用户基本信息注册一个，并生成自己的token来管理会话；
• 用户已存在，无需注册，但最好重新生成自己的token来管理会话，实现重登陆后老token失效的效果；
• 第三方可以设置自己的token过期时间，来降低用户的登录次数；
1.7、此后，用户再从DeBox中进入三方系统，则检查内置浏览器中是否有三方的token
• 存在三方token，则直接使用token建立第三方会话；
• 不存在三方token，则跳转到登录授权页面，回到第1.1步。

2、也可以通过区块链静默的方式拿到用户的wallet_address

https://docs.debox.pro/zh/APIs/BlockChainTransaction
但要实现登录注册，则需要钱包签名和鉴权，请参考Web3文档。

第三方系统运行在DeBox外部​

2.1、三方系统运行在非DeBox内置浏览器时，一般多为Web2用户，此时建议使用邮箱注册，
用Web2的方式打造三方系统，获得vBOX积分、NFT只是数据库的虚拟数字，当累计到一定额度，用户会主动寻找变现渠道，
此时用户会主动下载DeBox，提供DeBox地址把游戏的虚拟资产转入DeBox钱包中，完成用户转化。
或者把游戏平台积分通过vBOX积分支付提领到DeBox账户中。
2.2、游戏设计时要考虑好经济模型，虚拟数字和实物资产要1:1对应，不要产生泡沫。
2.3、游戏平台要实现邮箱老账户一键关联DeBox新账户功能。便于Web2系统一键平移为基于DeBox的Web3系统

二、关于积分、NFT流通问题。​

1、以游戏系统举例。用户在玩三方游戏的过程中，用数据库存储所产生的虚拟资产，这样游戏道具可以快速的、零成本的流通。
2、用户玩游戏获得虚拟资产，慢慢积累，到一定程度，一次性提取到区块链上。
3、比如开始只有5个，10个积分，此时存在数据库中。慢慢积累到1000个积分时，此时用户通过【提领资产】实现资产真正上链，或者 通过把Web2账户一键关联DeBox账户，把游戏平台积分通过vBOX积分支付提领到DeBox账户中。
以上既可以简化虚拟资产流通，降低区块链等待时间成本和交易手续费摩擦，又可完成与DeBox的集成。

三、关于邀请分享：​

1、可以通过消息推送Api发一条富文本消息，带链接。好友点击链接，可以进入游戏介绍页面，并点击【开始游戏】进行玩游戏。链接里带上分享者的uid，便于存储邀请关系；
2、也可以构造一个专门的分享页面，用于介绍游戏、如何玩、怎么赚积分、NFT、如何上链、如何一键绑定DeBox账户的介绍等。
下面是个大大的按钮【开始游戏】，进入游戏主页 ；
此页面可以通过【右上角】【…】【分享】【选择社群】分享到具体社群里。