概述与背景
· 门户概述
信息资源开放门户主要针对企业、公众用户使用,使得社会公众能够获取政府大数据共享开放带来的资源,同时政府也能够通过此门户窗口获取社会资源信息。通过统一信息展示窗口,包含热点动态、资讯中心、互动中心、数据资源、数据服务等内容,方便用户获取政府最新新闻信息、最新数据信息、开放数据信息。
门户系统按照数据的编目,分类逐级展现数据大数据平台沉淀的各类数据目录,提供用户进行浏览、查询和检索功能,数据目录需展现数据的基本描述信息,包含数据来源、数据属性、数据周期、数据关联应用等。
对外门户需实现数据申请与审批的功能,在用户查询不到所需数据信息的情况下,允许用户提出数据使用的申请,申请信息包含数据描述、使用用途、数据周期等。
用户发起数据申请后,系统管理员需要进行审批,包含检查数据是否存在、是否需要脱敏处理、是否可以对外开放等,审批通过以后,系统运维人员会根据数据申请信息和审批结果信息,进行相应数据的开发、发布,完成后通知数据申请用户。
对于已经公开数据,系统提供数据查询及下载的功能, 查询可支持条件输入查询、下载可支持TXT/CSV/PDF等格式。
建设信息资源开放APP,向市民、企业提供移动端的信息资源服务。
对于已经开放的数据,提供数据查询功能,查询可以支持条件输入查询,类型包括TXE、WORD、Excel等格式。
· 背景
随着信息化水平的快速提高,企业内部应用数量变得愈发庞大、臃肿,而且组织内往往因为缺乏沟通而导致很多应用之间功能重复,不仅造成开发资源的浪费,也增加了应用的维护和管理成本,同时这些繁杂、臃肿的应用也给用户的检索使用带来了极大的不便,面对用户日益多元化和个性化的需求,企业自身的资源与能力已然变得力不从心。
因此信息化迎来了一波开放化的发展潮流,企业提供基本的服务,然后通过开放自身接口,让第三方开发者得以通过运用和组装其接口以及其他第三方服务接口产生新的应用,使得该应用能够统一运行在这个平台上,既能实现市场的拓展,又让用户需求得到了最大程度的满足。这种传统模式向 “开放平台”模式转型,成为新一代互联网发展的主旋律。
· 跨部门的资源共享与应用整合
跨部门的资源共享与应用整合。信息中心可借助平台信息共享和应用整合打破各部门信息孤岛,使得各部门之间共享资源,形成良性循环,从被动的IT服务部门向信息化主导部门转变。
· 应用碎片化、水平化拓展
应用碎片化、水平化拓展。将企业庞大、臃肿的应用碎片化,使得应用更加轻量级,减少对应用的维护成本,同时,轻量级应用更易于分类、检索、统计,方便企业将优质的应用资源推送给用户。
· 一体化应用,一站式服务
一体化应用,一站式服务。政府或者企业各部门开发的应用通过平台进行接入整合,统一通过平台应用商店进行展现。用户在使用各种服务时只需要唯一登陆就可以使用所有的服务,真正实现统一平台、统一身份,一站式服务。
注册开发者
如果您是第一次使用应用接入平台,首先需要注册账号,即申请平台开发账号。

点击注册之后出现如下信息,若选择成为开发者则进入应用系统注册界面,若选择我要登录则进入登录界面。

应用创建
应用审核
审核通过之后,系统会自动分配App Key和App Secret。此时再查看开放平台的应用详情页面,可以看到该应用系统已通过审核且分配了登录名和密码。
说明:App Key和App Secret为应用的app_id和密钥secret_key,是应用在平台的唯一标识,用于应用的身份认证,开发者需妥善保管。

资源目录的查找与使用
API的查找与使用
API可以根据服务目录进行分类查找,可以根据更新时间、浏览次数、申请次数、收藏次数进行排序,可以根据关键字进行检索

点击API标题可以进入API详情界面,可以查看基本信息,可以进行API测试、收藏、申请等操作。

· API的使用规范
为了更好的保障线上应用有良好的用户体验,请开发者按照此规范对开放平台API进行合理使用。若因违规调用相关API导致用户体验受到不良影响,警务云计算中心将有权按照相应处理办法对违规调用接口的应用进行处理。
API使用规范:
1. 所有接口均需按照开放平台接口的描述进行使用,详细描述可参见开放平台API列表。
2. 开发者对于用户信息类接口需谨慎使用,不得将用户信息用于除应用功能所需之外的一切用途。
3. 开发者在使用日志、状态类接口时需让用户确认,不得在用户不知情的情况下以用户身份进行发布。接口调用通过审核后将不得随意更改,若要更改则需进行申请。
4. API使用规范包含但不限于以上三条,任何影响用户体验、网站安全的功能都将被视为违规情况。
API违规调用处理办法:
1. 开发者通过用户信息类接口调用用户信息用于除应用功能之外的其他用途或属作恶应用,一经发现立即对该应用进行下线处理。应用相应功能修改完毕后可再次向平台申请上线。如果该应用属于再次违规将不得再次申请上线。
2. 对于日志、状态、通知类等接口违规调用,平台将第一时间通知该应用开发者进行整改,同时视对用户体验影响程度大小对该接口进行暂停使用或频率限制。调整完毕之后可申请恢复使用违规调用接口。此外,开放平台有权对违规应用进行公告。
3. 申请邮件标题统一为“应用“***”申请开通违规调用接口”,邮件内容注明APP id、APP名称、违规事项、解决方案及修复日期。
· API的收藏
点击收藏按钮即可收藏此API。

若此API已经收藏过了,则会出现提示“不能重复收藏”。

收藏的API可以在用户中心-我的收藏-收藏的API中找到,同资源收藏。

· API的申请
点击申请按钮,进入API申请流程


最下方的API列表中,展示申请的API,可以点击新增服务,增加要申请的API,点击删除选中可以删除列表中的API,点击清空列表会清空列表中的API。点击提交申请之后进入申请审核流程,页面显示如下:

API申请审核通过后,页面显示如下:

· API的测试
通过API申请审核之后,可以进行API测试,点击测试按钮进入API测试界面,选择应用系统,填写请求参数进行测试,查看返回内容。

SDK下载
SDK封装服务中心的API。服务中心提供SDK供开发者下载参考。

· 资源统计信息
累计开放数据量是指系统中已发布的开放目录库表资源数据总量。
累计下载调用量是指系统中文件资源下载次数及api接口调用次数总和。
开放数据目录数是指系统中已挂接资源的目录总数。
开放接口目录数是指系统中已挂接接口资源的目录总数。
数据项数是指系统中已发布资源目录信息项数总和。
注册用户数是指系统中已注册的用户数总和。
接入部门数是指系统中已录入的市本级部门数。
接入区县数是指系统中已录入的县市区数。

· 常用分类展示
通过“领域分类”、“部门分类”和“区县分类”,可以快速跳转到资源目录板块下。

· 平台操作说明
“开发注册”展示用户注册操作说明。“数据目录”展示平台开放目录列表。“API指南”展示平台接口调用规范。

· 最新速递
按照访问热度、时间线展示部门发布的资源。

· 站内公告和帮助中心
展示的是管理平台发布的公告信息。开放门户有站内公告和帮助中心两个栏目,在管理平台中则维护相应栏目的公告信登录注册。

· 注册
填写相关信息后点击注册,跳转到注册成功页面。
.png)
注册成功页面有两个跳转选项,成为开发者会跳转到注册应用系统的页面,只有注册了应用系统才能成为开发者。我要登录则会跳转到登录页面。
.png)
· 登录
填写用户名和密码,点击登录。

· 忘记密码
如忘记密码,则点击【忘记密码?】进入找回密码页面,填写账号、验证码,通过绑定的手机或邮箱进行验证,重新设置密码。如下图三所示。
.png)
.png)
.png)
· 查找
左侧为部门检索,点击左侧部门,右侧资源列表中会显示相应部门发布的资源。右侧上方有数据领域和文件类型的筛选条件,点击则会筛选相应的资源。
排序方式有综合排序、更新时间升降序、按数据量升降序、按评分升降序、按下载量升降序和按浏览次数升降序。

· 资源详情
资源详情显示资源名称、数据量、文件量、API量、数据领域。下方展示基本信息、信息项、数据查询、数据分析、文件下载、API服务、互动交流。在右上方可以对该资源进行评分、分享、收藏、纠错操作。

· 资源数据查询
点击数据查询后跳转到资源数据列表页面,显示的是该资源下的所有数据,点击单条记录可以查看词记录的详细信息。
.png)
.png)
· 资源评价
资源评价是指对该条资源进行评价,分为准确性、及时性、满意度和可用性4个方面进行评价。该用户的评分取得是这四项的平均值,资源的评分取得是所有用户评分的平均值。

· 资源收藏
点击加入收藏,可对资源进行收藏,在个人中心-我的收藏能够看到你收藏的这条资源信息。

· 附件下载
点击文件下载进入文件展示页面,点击下载图标,就能下载相应的附件。

服务目录
· 接入指南
点击【查看接入指南】,跳转到详细的接入指南页面。
.png)
简单清晰的开发流程
四个步骤简单明了的介绍开发流程。
.png)
为用户提供多样性服务
点击【海量资源】页面跳转到资源目录页面,点击【开发者注册】页面跳转到应用系统注册页面,点击【服务接口】页面跳转到服务目录页面,点击【应用商店】页面跳转到应用商店页面。
.png)
提供详细的开发者文档
点击【开发者SDK】将直接下载新点门户服务调用SDK使用指南;点击【开发者文档】将跳转到服务指南页面如下图二所示。
.png)
.png)
· API目录
页面左侧为部门筛选条件,选择部门后,右侧API列表中会显示相应服部门的API。右侧上方提供了关键词检索,排序方式有综合排序、按浏览次数升降、按收藏次数升降、按申请次数升降。
.png)
API详情
点击api名称,能够查看api详情。能够看到api的浏览次数、申请次数、收藏次数、连接的应用数量和所属目录。下方有有一些api的基本信息,api的请求参数和api的返回参数信息。还有错误参照码,服务级错误码参照、系统级错误参照码及错误码格式说明。
.png)
.png)
API申请
Api申请是必须的先注册应用系统,应用系统为必选项,注册应用系统见11.5。填写申请表,申请api,一次可以申请多个api,申请后会发流程给后台管理员,默认发给admin。系统管理员在首页待办中能够看到该条api申请信息,可以通过和退回该条申请信息。
.png)
.png)
流程审核完后,能在开放门户看到审核状态。
.png)
审核完成后返回token,token有效期为30分钟,token过期后需调用刷新token接口。能够在用户中心-我的申请-api申请看到你所申请的api。
.png)
API收藏
.png)
点击收藏,收藏成功。能够在个人中心-我的收藏-api收藏中看到该条api的收藏记录。
.png)
API测试
.png)
统计服务
分别根据部门资源目录数量、部门API数量、服务对象、资源目录主题分类进行统计。
.png)
.png)
· 首页
点击【首页】显示应用系统申请、API申请、投诉反馈、我的收藏、消息提醒、资源、目录精选和API精选,点击相应模块可快速进入到该页面。

· 消息中心
点击【消息中心】展示所有的提醒消息,后台管理员给你回复后的消息。可以把消息设为已读,也可以删除消息。点击消息名称可以查看该条消息的详情信息。

· 我的申请
点击【我的申请】显示所有申请信息,能够根据审核状态来查询相应状态的申请列表,点击api名称能够查看相应的申请详情。
.png)
.png)
· 我的收藏
点击【我的收藏】可以查看收藏的资源和收藏的api列表。点击【查看】可查看资源和api的详情。点击【删除】可以删除收藏的资源或者api。

· 我的反馈
点击【我的反馈】展示反馈信息的列表,可以看到你的反馈的回复信息,是已答复还是未答复,点击反馈标题能够查看具体的反馈。
.png)
反馈消息详情页面:
.png)
· 应用系统
注册应用系统后开放门户用户才能成为开发者。用户可以查看注册的应用系统列表,可以根据应用系统的认证状态来筛选应用系统。点击右上角注册应用系统按钮,跳转到注册应用系统页面,填写相应的注册信息,点注册可以发起注册应用系统的流程,默认发送给系统管理员审核。
.png)
应用系统注册页面:
.png)
注册申请发送到系统管理源,系统管理员可以在下面的管理平台审核页面进行审核,也可以在首页待办进行审核。
.png)
.png)
审核通过后,会返回该应用系统的appkey和appsecret。
.png)
· 个人资料
点击【个人资料】可以查看个人资料,绑定手机和邮箱,点击右上角【编辑】修改个人资料。
.png)
.png)
· 密码修改
可以对开放门户用户的密码进行修改。
