服务中心—用户手册(面向外部开发者)
介绍
服务中心可以提供给外部开发者便利的申请接口,访问接口的方式。用户可以通过自己的需求注册应用并申请接口,通过后可以api接口调用服务获取结果。下面是模块介绍
首页
首页用于展示,可以查看最新服务、热门服务、资源种类等相关的展示信息。
首页样式
资源浏览
可以查看系统现有提供的资源,比如驾驶人信息资源、车辆信息资源等,也可以条件筛选。
资源浏览.png
字典浏览
字典查阅,一般无需关心。
字典浏览界面
服务列表
可以查看所有的已经通过的服务,可以对服务查看api明细以及对服务进行申请
服务列表界面
我的服务
-
我的应用授权:可以查看申请的应用状态,比如待审核等。
我的应用授权界面 -
通过的服务申请:可以查看通过的服务申请,并且可以查看服务api明细并且可以在线测试。
通过的服务申请界面
-
待审核的服务申请:可以查看正等待审核的服务申请。
待审核的服务申请界面 -
驳回的服务申请:可以查看被驳回的服务申请。
驳回的服务申请界面 -
通过的资源服务:可以查看通过的新建服务申请(即自己申请的服务,不为平台提供的)
通过的资源服务 -
待审核的资源服务:可以查看正在等待审核的资源服务
待审核的资源服务 -
驳回的资源服务:可以查看被驳回的资源服务
驳回的资源服务
申请
申请调用服务接口需要用户建立、应用新建及审核、查看并申请服务及审批三个流程。
用户建立
现在没有开放接口调用用户的注册,需要联系后台新增对应的用户信息,然后使用对应的用户信息登录系统。
应用新建及审核
查看申请服务及审核
调用
在线测试可以测试接口的连通性,通过之后需要通过后台进行服务申请调用。分为鉴权、调用两部分
鉴权
鉴权即通过appId、appKey调用鉴权接口来获取返回token,后续的调用通过token调用即可。
示例:http://localhost:8004/api/jwtApp/auth?appId=1&appKey=appKey
(项目根地址仅供参考)
appId为应用id、 appKey为应用对应的key。
返回示例:
{"token":"eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImNyZWF0ZWQiOjE1MDc3OTM2MjgzMzIsImV4cCI6MTUwNzgwMDgyOH0.hBrMfZk5OWl6scOyTldRdaUKnzQ983knbpmHJmZy3-pg5Qr_UNU-mv--e5xUZOMPrqx2VF1454f2WDIBSCIkng"}
调用
调用需要使用鉴权返回的token进行调用,token需要放在headers中,名字为access-token。
调用示例:http://localhost:8004/service/serviceCall/1/47?id=1&name=test
(项目根地址仅供参考,header已省略。)
网友评论