###前言
欢迎你加入 bong 开放平台的大部落,对于每一位开发者我们都倍感珍贵。不需要掌握硬件知识和拥有专业设备,你就可以学习和运用通过传感器全时监测所获得前所未有的海量身体数据,开发出真正把虚拟带入现实的各种有趣应用,并且通过这些应用去改善你所关心的人们的生活。第三方应用将内嵌到 bong iOS 和 Android 软件中,每一位 bong 用户均可以访问到这些应用。
###与我们合作
现在bong可以通过SDK提供互联和数据共享的服务给合作伙伴,请将你的合作请求发送给 jinjia@bong.cn
###关于bong
bong 是世界上第一个能够全自动识别你的运动和睡眠状态的手环,只要佩戴在手腕上,无需手动切换识别状态。更重要的是,续航能力长达四周,省去频繁充电的烦恼,而且佩戴无感,不会有卡手的感觉。现在 bong 更进一步,通过开放接口与第三方应用开发者实现合作共赢,帮助你在可穿戴设备的第一波浪潮中抢得先机。
###bong无线开放平台
####android SDK 文档
####iOS SDK 文档
bong开放平台为无线应用(移动app)提供各种基础能力和服务,以让app开发者快速、低成本和bong互通:
- 分享能力:获取Yes! 键 短触、长触事件,获取bong传感器数据。
- 数据开放:通过sdk获取、驾驭海量数据。
###OAuth 2 认证
####授权原理图示

####OAuth 2文档和库
- OAuth 2
###授权过程
- 需要向我们提交的资料
- 测试和正式环境的地址
- 请求 request_token
- 请求 access_token
- 用 refresh_token 重新请求 access_token
- 签名密钥
###API说明
- 名词说明
- 天详细数据接口
- 天综合数据接口
- 睡眠数据接口
- 用户头像接口
- 用户资料接口
- 推送消息接口
- Yes! 键接口
- 错误码说明
###调测、账号注意事项
- [测试环境]和[线上环境]的账号、数据完全独立,交叉登录则会报密码错误或未注册;开发者可到bong[开放平台]
下载测试环境的安装包,来自助注册测试账号并在测试环境使用、调测。测试环境App下载:iOS、Android
- 默认最初分配的AppID、AppKey等信息仅对测试环境生效,意味着只能在测试环境授权通过并调测,否则可能报授权失败。
- 测试完成将要上线时请到[开放平台] 申请APP上线,用户即可使用,通过后线上环境即生效。
###开发环境
- 测试环境:账号、数据与正式环境隔离,测试专用,线上用户看不到。
- 预发环境:预发环境(GM)和线上环境账号、数据体系一致,预发环境测试通过后将发布线上。
- 正式环境:线上用户使用的环境。
###用户界面规约
- 用户界面规约 v0.1
###接入流程
- 提交应用。认证开发者需要提交的内容有:应用名称,重定向 URI,APP 主页,图标,应用说明(OAuth 2)。
- 测试开发。提交审核通过后,我们会返回开发者测试环境的client_id、client_secret、sign_key等信息。另外我们会提供测试环境的测试账号以及bong的测试app,测试app中会展示开发者的测试应用,并可点击进入,帮助开发者调通整个流程。
- 联调上线。第三方应用和 bong 开放平台的测试环境联调成功后,可以申请接入正式环境,申请接入时需要提供应用的使用文档,通过后正式发布到 bong app 内置的「我的应用」栏目中去。
- 后期运营。我们目前会通过官方宣传渠道和应用内的「编辑推荐」的办法为有创意的应用提供持续的用户导入。
###什么样的应用将被拒绝
- 暴露用户隐私
- 不符合国家有关法律法规
- 广告或含有大量广告材料
- 与宣传的功能不符或含有隐藏、虚假的功能
- 界面粗糙,逻辑含有错误以及过于消耗手机电能
- 载入速度过慢,导致界面崩溃
- 推广不健康的生活方式
- 内含错误的诊断信息
- 与已上线的应用相似的应用
###什么样的应用将被下架
- 滥用 API
- 上线后的运营过程中出现了被拒绝应用中的任何一条的
- 恶意记录、传播用户授权的信息
###运营支持
上线后,我们会持续对有创意有趣味的 app 进行运营上的支持和推广。