跳到主要内容

Q&A

API 文档Q&A​

技术支持
示例展示

参数 group_id是怎么获取的?​

1、打开App，进入某个群，点击右上角的分享按钮，在底部弹出的界面中选择“复制链接”，id即为group_id
示例：https://m.debox.pro/group?id=fxi3hqo5，其中fxi3hqo5为group_id

如何调用接口向群组发“纯文字”消息？​

1、开发者需要在开放平台后台申请开发者key；
2、在开发者后台绑定对应的DeBox用户；
3、通过js-http实现bot纯文字消息发送，接口为/messages/group/send，示例：

curl -X POST -H "Content-Type: application/json" \
-H "X-API-KEY: t2XAlEF6......" \
-d '{"to_user_id":"uvg2p6ho","group_id":"fxi3hqo5",\
"object_name":"text","message":"i am message sent by bot"}' \
"https://open.debox.pro/openapi/messages/group/send"

如何调用接口向群组发带超链接的消息？​

  1. 开发者需要在开放平台后台申请开发者key；
  2. 在开发者后台绑定对应的DeBox用户；
  3. 通过js-http实现bot消息发送，接口为/messages/group/send，示例：
curl -X POST -H "Content-Type: application/json" \
-H "X-API-KEY: t2XJ........lEF6" \
-d '{"group_id":"l3ixp32y","object_name":"richtext","title":"我是标题","content":"i am 富文本 \
 {\"uitag\":\"a\",\"text\":\"点击我\",\"href\":\"https://debox.pro/\"}将跳转"}' \
"https://open.debox.pro/openapi/messages/group/send"

如何调用接口向私人发消息？​

  1. 开发者需要在开放平台后台申请开发者key；
  2. 在开发者后台绑定对应的DeBox用户；
  3. 通过js-http实现bot消息发送，接口为/messages/private/send
curl -X POST -H "Content-Type: application/json" \
-H "X-API-KEY: t2XAlEF6......" \
-d '{"to_user_id":"uvg2p6ho","object_name":"text","message":"i am message"}' \
"https://open.debox.pro/openapi/messages/private/send"

授权成功后，为何没有跳转到redirect_uri?​

  1. redirect_uri 地址不对，访问不了；
  2. 地址正确，但带有？#:% 等特殊字符 ,需要用encodeURIComponent对整个redirect_uri编码
  3. redirect_uri需要是https地址，否则在iOS上打不开（Android和web上是可以的）

登录授权成功后，在App端能进入redirect_uri页面，但在web端浏览器上一直initialization转圈？​

  1. web端必须带上response_type=code参数，才能正常拉起授权页面，进入redirect_uri页面

支付授权环节，报error code = -2011？​

  1. 请按规范传参数，不要少传，也不要多传入，否则会出现意想不到的错误。 比如多传入user_id参数，就可能报code = -2011 错误。
  1. 需要在开放平台上配置App logo参数。

授权页面不显示MiniApp名称？​

  1. 需要在开放平台上配置App name 参数。

积分支付的参数中，谁是支付方？ 谁是收款方？​

  1. pay_type代表授权者的身份。 如果其值为send，则表示授权者为支付方；如果其值为receive，则表示授权者为收款方；
  2. 开发者的身份为授权者的对手方。 即如果授权者为send（payer），则开发者为receiver；如果授权者为receive（receiver），则开发者为payer;
  3. pay_type的值决定了授权者和开发者的身份，先定pay_type，而后定payer_user_id、receiver_user_id；
  4. pay_type=授权者=send|receive , 确定了授权者身份，开发者自然为另一身份。
  5. payer_user_id、receiver_user_id 只能来自于授权者和开发者 ，并且必须根据pay_type值正确填写，否则会报错。

【实验室】【DApp】【我的收藏】里，为何DApp的Logo没有显示？​

  1. DApp收藏中的Logo路径是https://domain/favicon.ico
  2. 请把DApp的logo命名为favicon.ico，并确保 https://yourDomain/favicon.ico 能正确取到自己的Logo

什么是授权临时票据（code）？​

  1. 第三方通过code进行获取access_token的时候需要用到，code的超时时间为5分钟，一个code只能成功换取一次access_token即失效。code的临时性和一次性保障了DeBox授权登录的安全性。

代码逻辑都对，为何拉不起来支付页面？​

  1. gas price给的太低，小于base价格。
  2. 资产不足。资产余额小于转账金额+gas费。
  3. 网络不好，由于区块链一些节点在境外，可能存在因网络不通导致无法正常转账,科学上网。

如何判断浏览器是否内置了DeBox环境?​

userAgent包含DeBox

  const isDeBox = !!window?.navigator?.userAgent?.includes('DeBox')