开发者中心

1. 概述

应用开发主要是通过原生的Rsetful API或SDK等方式实现和云平台进行数据对接、数据分析、远程监控等,结合自己的需求,来实现相关产品应用程序的开发,要实现应用开发,可以有几下三种途径:
方式一:《云平台应用设计器》,该工具提供了在线拖控件,一键发布等功能,并提供曲线图、柱状图、蛛网图、位置、开关、表盘、控件等,快速实现WebAPP的开发与浏览,支持兼容PC或移动设备;
方式二:开发者只需在正在开发的应用内调用云平台提供的SDK实现快速开发APP;
方式三:利用平台提供的RESTful API接口编码实现APP开发;
不管采用的是以上哪种方式,应用开发的第一步是首先需要有一个APIKEY,每个用户有且只有一个且有过期时间限制,其作用是设计、浏览应用时的唯一凭证。 在开发者中心->个人中心->ApiKey管理的页面中,点击页面中的"生成"按钮及选择时间期限,然后“确定提交”创建一个apikey
之后我们继续分别讲解三种方式开发应用的过程。

2. 方式一:利用《云平台应用设计器》实现应用开发

2.1.添加应用

进入应用管理页面,点击“新增应用”,跳转到新增应用界面,如下:

填写完成后,点击“确定”,添加成功。

2.2.设计应用

应用模块选择是非“自行设计”的,直接点击发布图标,发布后即可浏览;选择“自行设计”的,在每个应用列表右边点击“设计”连接,连接到“应用设计器”工具页面。 设计好后,可以点击右上角的“保存”按钮完成设计区布局的保存,若想立即发布则把右边的“同时发布项目”复选框打钩即可。

2.3.发布/浏览应用

对于在应用设计器中还未发布的应用,也可以在应用列表页点击“发布”按钮,生成应用文件存储到服务器,即可在线浏览

3. 方式二:调用SDK进行应用开发

SDK封装了手机与云端的通讯过程,这些过程包括请求、实体封装、结果返回等。使用SDK可以直接调用各个方法,开发者只需关注APP的UI和UE设计即可,而相对复杂的协议与错误处理等事项可忽略。

3.1.下载SDK文件

应用开发的SDK目前主要包含Javascript、PHP、Android、C#、Java等几种语言的SDK包,根据你使用的语言,移步至API SDK页面下载相应语言的SDK文件,其它语言的SDK我们会不断的推出。

3.2.引用或拷贝SDK文件到你的程序中

建议将下载好的SDK包拷贝一份到你的应用程序某文件夹中,由于各种语言的使用SDK方式不尽相同,大家根据语言特点使用SDK。
Javascript的使用方式是:在HTML页面引入<script src="nlecloud-sdk.min.js"></script>
PHP的使用方式是:在PHP代码中引用require 'nlecloudsdk.php'
C#的使用方式是:在项目中引用SDK Dll文件

3.3.调用SDK方法

根据需求调用相应的方法即可,各个方法请求或返回的“实体对象”请参考RESTful API页面每个接口的请求参数或响应参数SDK有哪些方法请查看SDK文件里的定义
Javascript参考如下: C#参考如下:

3.4.调试/发布应用

根据需求调用SDK方法完成业务功能,同时设计好UI/UE等工作,最后编译调试程序,完成应用开发。完成后的应用暂时不支持部署到云平台上,用户自行部署。

4. 方式三:请求RESTful API实现APP开发

不使用SDK,直接使用原生RESTful API接口也能实现应用的开发,采用这种方式更能理解与学习HTTP请求的整个通讯过程。 接口统一基于JSON格式(什么是JSON),您可以使用任何标准的 HTTP 客户端调试或访问API接口,如:

4.1.获取AccessToken

AccessToken由APIKEY等信息经过多重加密后生成的一串字符串,是请求所有接口时(http://api.nlecloud.com/users/login除外)的头部参数。 AccessToken 具有有效期,期限就是APIKEY申请时候选择的到期时间,失效后应用将不能被浏览或查看。
获取 AccessToken的唯一途经是请求“http://api.nlecloud.com/users/login”接口,返回响应中会带有 AccessToken 字段:

     {
          "ResultObj":
          {
            "UserID": 1,
            "UserName": "sample string 2",
            "Email": "sample string 3",
            "Telphone": "sample string 4",
            "Gender": true,
            "CollegeID": 6,
            "CollegeName": "sample string 7",
            "RoleName": "sample string 8",
            "RoleID": 9,
            "AccessToken": "sample string 10",
            "ReturnUrl": "sample string 11",
            "DataToken": "sample string 12"
          },
          "ErrorObj": {},
          "Status": 0,
          "StatusCode": 2,
          "Msg": "sample string 3"
     }
    

这个AccessToken参考值类似以下:
CBE131838F574CC69C5C19033CAAB3CD7CAD57045DF07336C061742D700A52FAD1CA2A740777211EB357D33A4B9E0D3F96BE9D9EB8F96485FE5BE72A6E5E0717AD158B535428BBB6CC506679DDB7C20B6B7E659807C96E2DF26D2AE8D4B9CF76CF9E3FE49EF0C5AC151A46123B07968F18678222C97D2B6A79E4E46C5FBFAA3ED13428A0FFDC2E4FB2D88F9526FFCBC4C6A10299A5A199D97C5A9246C34A6220AB8B48F1CE1F5CAB57905B6A4054D1A588A196D303D4B80B89D4FE2FFB032DA7FAA934305DCD2B30C884031AC870E967768173C0233D3DEAAE058B7B4E287F27A4078CF22A5F4B94A2203514E9A6644A
调用云平台API的顺序如下:

  1. 判断本地是否有 AccessToken,以及 AccessToken 是否过期
  2. 如果不存在 AccessToken 或者 AccessToken 过期,调用用户登录接口,获取并保存 AccessToken
  3. 使用 AccessToken 调用其它接口

4.2.请求API接口

根据需求调用相应的接口即可,各个接口请求或返回的“JSON对象”请参考RESTful API页面每个接口的请求或响应示例
云平台有哪些接口请点击查看接口总细目

4.3.调试/发布应用

根据需求调用接口完成业务功能,同时设计好UI/UE等工作,最后编译调试程序,完成应用开发。完成后的应用暂时不支持部署到云平台上,用户自行部署。