#开放API系统说明文档 修订者 : 任孟洋 , 日期 : xx/xx/xx

##1 概述

本开放系统主要对第三方服务商提供开放平台服务 认证鉴权服务 用资源获取服务 HTTP协议头认证(Basic MTEwMjA4NDI5NDpha3U4aEN5WEJkOVNxWWtU)

##2 接入指引

json : http://auth.xx.dev.com/apis/rest/authService/authorize/json xml : http://auth.xx.dev.com/apis/rest/authService/authorize/xml

##3.参数说明

t_ :请求发起时的时间戳,服务器端会对时间戳进行校验,时间戳与真实时间相差较大时将返回错误信息. p_ :和时间相关的数值,计算方式为 (t_ % 10000 ) * 3 + 2345 access_token :通过致云桌面软件登陆会生成访问Token client_id :开放系统为第三方服务商提供Open-key client_secret :开放系统为第三方服务商提供的密钥 auth_code :接入鉴权接口生成的授权码

##4.错误码

CODE码 说明
100014 访问token已过期,过期时间一般为3个月
100008 该client_id 不存在
100009 HTTP协议头认证非法
100002 client_id 访问非法
100019 授权码不存在,请重新授权
100018 该授权码无权限访问
100020 授权码已经过期,请重启授权
100021 授权客户端非法持有授权码
100023 授权用户非法持有授权码

##5.通用码

CODE码 说明
200 成功码
304 未修改
400 请求无效
401 未授权
500 服务内部错误
501 不支持该客户端
601 参数非法
602 内容为空

##6 API列表

####6.1鉴权接口

NAME EXPLAIN
url http://auth.xxx.dev.com/apis/rest/authService/authorize/json
支持验证方式 HTTP协议头
格式 JSON
http请求方式 GET
是否需要鉴权 不需要

请求实例

http://auth.xxxx.dev.com/apis/rest/authService/authorize/json?access_token=************* &t_=1422339152058&p_=8519

参含义数 含义
access_token 通过致云桌面软件登陆会生成访问Token,过期时间3个月
client_id HTTP协议BasicAuth,UserName值,由开放平台颁发
client_secret HTTP协议BasicAuth,Password值,由开放平台颁发

响应结果

{ "data": { "auth_code": "c3a8ad070c745db455e30a51511dca819b607bf7" }, "code": 200, "message": "ok" }

####6.2用户信息获取接口

NAME EXPLAIN
url http://auth.xxxx.dev.com/apis/rest/userService/getUserInfo/json
支持验证方式 HTTP协议头
格式 JSON
http请求方式 GET
是否需要鉴权 需要

请求实例

http://auth.xxxx.dev.com/apis/rest/userService/getUserInfo/json?access_token=************* &client_id=********** &auth_code=********** &t_=1422339152058&p_=8519

参含义数 含义
access_token 通过致云桌面软件登陆会生成访问Token,过期时间3个月
client_id 由开放平台颁发
auth_code 由授权接口生成

响应结果

{ "data": { "username": "li******40", "truename": "李**", "sex": "3", "phone": "13******0170", "is_admin": "1", "status": null, "avatar": "http://avatar.xxx.dev.com/000/00/11/52_avatar_small", "created": "2017-11-30 10:37:30", "nowtime": 1522404566 }, "code": 200, "message": "ok" }

####6.3企业信息获取

NAME EXPLAIN
url http://auth.xxx.dev.com/apis/rest/companyService/getCompanyInfo/json
支持验证方式 HTTP协议头
格式 JSON
http请求方式 GET
是否需要鉴权 需要

请求实例

http://auth.xxx.dev.com/apis/rest/companyService/getCompanyInfo/json?access_token=************* &client_id=********** &auth_code=********** &t_=1422339152058&p_=8519

参含义数 含义
access_token 通过致云桌面软件登陆会生成访问Token,过期时间3个月
client_id 由开放平台颁发
auth_code 由授权接口生成

响应结果

{ "data": { "company_name": "水磨沟区*******餐饮店", "company_type": "1", "tax_number": "6523248***************03404", "province": "", "city": "", "zone": "", "address": "乌鲁木齐市***巷186号", "disable": "", "tel_phone": "", "legal_person_phone": "133*****0170", "legal_person_name": "李**", "created": "2017-11-30 10:37:30", "nowtime": 1522404881 }, "code": 200, "message": "ok" }

##7其他 注意:所有接口都需要HTTP协议头认证 !

提供与测试人员

client_id:1102084294 client_secret:aku8hCyXBd9SqYkT ------------------------------------------------ access_token:9106c9fd1e138a042d4aedf94cede7a766e0 access_token:55427e5af26a1319e168beb699b0fd1b11e 注:上token如有误,请自己去测试系统中,自己提取

版权声明:

1、该文章(资料)来源于互联网公开信息,我方只是对该内容做点评,所分享的下载地址为原作者公开地址。
2、网站不提供资料下载,如需下载请到原作者页面进行下载。
3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考学习用!
4、如文档内容存在违规,或者侵犯商业秘密、侵犯著作权等,请点击“违规举报”。