管理平台API接入流程文档
一、接入流程图
二、API接入说明
开发者在接入开放平台开发时，申请和上线流程如下：
1.注册并登陆开放者平台账户
在智国互联开放平台中，只需手机号、验证码和密码即可进行注册操作。注册成功后进行登陆操作。
2.创建应用
在智国互联开放平台中，填写第三方应用的基本信息、相关参数（具体参数说明请见填写流程中说明）后，即可创建第三方应用。
3.开发者自行开发和测试，并上线
创建并通过审核后，第三方开发者可以根据接口说明文档，进行接口接入、调试、测试以及上线。
三、授权流程技术说明
智国互联开放平台授权给第三方平台的授权流程引用Oauth2.0的授权开放网络标准。
步骤1. 第三方平台方获取预授权码（code）
预授权码是第三方平台方实现授权托管的必备信息;
步骤2. 引导用户进入授权页，用户确认并同意登录授权给第三方平台方，完成授权流程。
第三方平台方可以在自己的网站中放置登陆入口，引导开放平台管理员进入授权页，授权后回调URI，得到授权码（authorization_code）和过期时间。
授权流程完成后，授权页会自动跳转进入回调URI，并在URL参数中返回授权码和过期时间
或者第三方可自己封装直接后端调用授权接口。
步骤3. 利用授权码调用智国互联开放平台的调用凭据接口
在得到授权码后，第三方平台方可以使用授权码换取授权智国互联的接口调用凭据（access_token，也简称为令牌），再通过该接口调用凭据，按照开发者
文档说明，去调用相关API。
步骤4. 令牌过期时，可通过refresh_token刷新令牌
为了开放平台安全性，所有调用令牌均有访问过期时间，当第三方想继续使用可通过refresh_token刷新令牌过期时间。
四、项目完整接入流程
为了能使第三方平台完整快速接入，可按照以下步骤顺序进行API对接：
1.创建、管理项目
首先提供小区名称、地址、经纬度坐标、物业管理处信息进行创建项目操作，其中项目所在区域uid可通过【地区管理】下接口获取相关数据；
【项目管理】还提供了项目列表、项目详情、更新项目、删除项目等API，相关操作以项目uid作为唯一标识。
2.创建、管理楼栋
根据小区实际的楼栋情况，在上一步创建的项目下新增对应楼栋；
【楼栋管理】还提供了楼栋列表、楼栋详情、更新楼栋、删除楼栋等API，相关操作以楼栋uid作为唯一标识。
3.创建、管理房屋
创建楼栋信息完毕后，根据每个楼栋的房屋布局情况，新增房屋信息；
【房屋管理】还提供了房屋列表、房屋详情、更新房屋、删除房屋等API，相关操作以房屋uid作为唯一标识。
4.新增、管理门禁设备
在创建完项目、楼栋、房屋信息后，方可添加门禁设备；根据设备在小区部署与作用范围，门禁设备绑定到对应小区下的楼栋，并设置好门禁所属权限；
其中设备ID可通过扫描门禁设备二维码获取。
【设备管理】还提供了设备列表、设备详情、更新设备、解绑设备、重启软件、重启设备、更新系统、更新固件等API，相关操作以设备uid作为唯一标识。
5.App端注册用户并申请钥匙
第三方平台基于智国开放平台的SDK开发APP，其用户可通过手机号注册进来成为第三方平台APP用户，并可申请门禁钥匙成为小区内的用户。
6.钥匙审核
当app用户发起门禁钥匙申请时，后台可查看到钥匙申请信息，后台可对申请信息进行核实并进行审核。
7.门卡授权、门卡管理
门卡分为普通卡与管理卡，门卡可对门禁刷卡开门。普通卡主要授权给普通住户使用，管理卡授权给物业管理员使用，门卡具有有效期，过期需要用户重新申请，或后台直接续期。
【门卡管理】还提供了门卡列表、门卡详情、更新门卡、删除门卡、续约门卡、启用/禁用门卡等API，相关操作以门卡uid作为唯一标识。