数据宝前置服务接口说明接口调用说明书版本V2_第1页
数据宝前置服务接口说明接口调用说明书版本V2_第2页
数据宝前置服务接口说明接口调用说明书版本V2_第3页
数据宝前置服务接口说明接口调用说明书版本V2_第4页
数据宝前置服务接口说明接口调用说明书版本V2_第5页
已阅读5页,还剩8页未读, 继续免费阅读

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

[数据宝前置服务接口说明]

接口调用说明书版本:V2.2

温州市大数据管理局

修订记录

修订版本

修订时间作者审核者修订内容

号

1.02021-08-17何桂清文档创建

新增第三方机构注册、创建业务接

2.02021-11-26何桂清

口

2.12021-11-29何桂清接口1.5修改参数注解

接口1.5修改入参、出参;新增查

2.22021-11-29何桂清

询第三方业务清单接口

接口调用说明书目录

接入规范.错误!未定义书签。

1.1使用说明........................................................错误!未定义书签。

1.2获取TOKEN..…错误!未定义书签,

1.2.1ifeUt.........错误!未定义书签

1.2.2功能………错误!未定义书签

1.2.3请求方式错误!未定义书签,

1.2.4请求内容错误!未定义书签,

1.2.5返回结果错误!未定义书签,

J/ipJ|IVxiv♦♦・・♦・・・・•・♦♦・・・・・・・♦♦♦・・・・・♦・♦♦♦・・・・・♦♦♦・・・・・・♦♦♦・・・・・♦♦・♦♦・・・・・♦♦♦♦♦・・・・・♦♦♦•・・・・・♦♦♦♦・・・・・・・♦•|J0

1.3.1典........................................................错误!未定义书签。

132功能........................................................错误!未定义书签。

1.3.3请求成...................................................错误!未定义书签。

1.3.4请求内容...................................................错误!未定义书签。

1.3.5返回结果...................................................错误!未定义书签。

1.4请求数据列表接口...............................................错误!未定义书签。

1.4.1iteilt........错误!未定义书签,

1.4.2功能.........错误!未定义书签,

1.4.3请求方式错误!未定义书签,

1.4.4请求内容错误!未定义书签

1.4.5返回结果错误!未定义书签,

1.5第三方机构入驻接口............................................错误!未定义书签。

1.5.1ifetlt..........错误!未定义书签,

1.5.2功能………..错误!未定义书签,

1.5.3请求方式..错误!未定义书签,

1.5.4请求内容..错误!未定义书签,

1.5.5返回结果..错误!未定义书签

1.6测试.............................................................错误!未定义书签。

1.6.1GET_TOKEN...................................................................................错误侏定义书签。

1.6.2REFRESH.TOKEN............................................................................错误!未定义书签。

1.7错误响应码列表.................................................错误!未定义书签。

接入规范

需要提供调用接口的服务器的对外访问IP地址,以用于IP访问的限制。

传输统一使用UTF-8编码。

1.1使用说明

用户有用户名和密码,使用用户名和密码调用接口

https://IP/openapi/get_token来获取令牌token,也可用这个接口刷新token,

token失效后只能用这个接口重新获取。也可在token失效前用原来的token调用接口

/IP/openapi/refreshtoken来刷新token。如果需要并发访问的,必须将

token保存到公用区域(如redis内存数据库等),供并发进程共享。否则并发进程

之间容易发生token冲突。

username:请向平台管理人员申请注册。

Password:请向平台管理人员申请注册。

1.2获取TOKEN

1.2.1地址

https://IP/openapi/get_token

1.2.2功能

可使用本接口来获取token或刷新,有效期为15分钟。

1.2.3请求方式

POST

1.2.4请求内容

请求参数说明:

参数名注释

username银行账号用户名

password银行账号密码

1.2.5返回结果

{“token”:〃xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx〃}

错误信息:

{'error,:'xxxx,xxxx')

1.3刷新TOKEN

1.3.1地址

https://IP/openapi/refresh_token

1.3.2功能

在token秘钥过期前,可使用本接口来刷新token,有效期为15分钟。

1.3.3请求方式

POST

1.3.4请求内容

请求参数说明:

token放在header

1.3.5返回结果

{“token”:,,xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx,,J

错误信息:

{‘error*:'xxxx,xxxx'}

1.4请求数据列表接口

1.4.1地址

https:〃IP/openopi/'retrieveitemlist

1.4.2功能

获取数据宝中所有在用口可以开放给其他系统的数据项清单

1.4.3请求方式

POST

1.4.4请求内容

token放header

ParamsAuthorizationHeaders(11)Body•Pre-requestScriptTestsSettings

Headerso10hidden

KFTVALUEjwt加空格再拼接token

QAuthorizationjwteyJ0eXAiOiJ<V1QiLCJhbGciOiJIUzl1NiJ9.eyj1c2VyX2lkljo2OS,

KeyValue

Response

1.4.5返回结果

"result":"OK",

"data":(

{

"uuid":,'bff7a092-a668-4887-964e-969c768c4586",

"type":"个人证黑",

"name":"居民户口簿。

"template":f

"W,

“曾用名”,

“身份证号码“,

“户类5T,

“与户主关系”,

“民旅”,

"出生日期",

“出生地”,

"赫寓"

“尸修/在他”,

”所傀添出所“,

“注幅标识”

]

},

{

"uuid":"3c9blb68-3f2a-4551-a001-Of6440393f2d",

"type":"个人证照”,

1.5第三方机构注册、创建业务接口

1.5.1地址

https:〃IP/openapi/'registerthirdparty

1.5.2功能

传入所需参数,自动注册笫三方对接用户账号,配置权限,并创建业务

1.5.3请求方式

POST

1.5.4请求内容

Header{"Authorization”:token}

ParamsAuthorizationHeaders(11)Body•Pre-requestScriptTestsSettings

Headersg10hidden

KaVALUEjwt加空格再拼接tokenOl

QAuthorizationjwteyJOeXAiOiJKV1QiLCJhbGdOiJIUzl1NiJ9.eyj1c2VyX2lkljo2OS,

Response

Body

参数名注释

sign签名

post_data请求参数(json格式字符串)

-real_name接入单位(系统)名称

-uniscid接入单位(系统)统一社会信用代码

-mobile_phone对接负责人手机号码

-ipjimit接入TP限制,英文“;”连接

-hour_limit每小时最大访问次数默认1000,不超过10000

-dayjimit每天最大访问次数默认10000,不超过100000

-biz_max_duration业务持续时间,最长不超过360,默认30

-biz_name业务名称

-itemjist值为L4接口获取到的数据项uuid列表

接入单位公钥(1024位)不带头尾-----BEGIN

-pub_key

PUBLICKEY-----------ENDPUBLICKEY-

post_data示例,

postdata={

"real_name":"第三方接入测试账号001",#接入单位(系独名称

"uniscid":"xxxx",#企业统一信用代码证

Hmobile_phone":,#对接负责人手机号码

"127.0.0.1;127.0.0.1",#接入IP地址

"hour_limit":"2000",#int每小时最大访问次致霖认100。

"day_limit-:"20000",#int每天最大访问次数默认10000

"biz_max_duration":"360\#业务持续时间,最长不超过360,默认30

"biz_name":"第三方楮入源试账号001诬I试业务",#播入业务名称

"item_list":[

"bff7a092・a668-488"964e-969c768c4586",

-6f22c830-b776-lleS-993e-38baf883ef31H

].#所需数据项清单,传接口1返回的uuid集合,不超过十项

"pubkey":"MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQ€5rQECnWB15fB",

卜接入单位公钥(1024位)不带头尾-----BEGINPUBLICKEY-----------------ENDPUBLICKEY-------

1.5.5返回结果

{"result":"success","data":{"msg":"注册成功","password":password>

1.6第三方机构业务清单查询接口

1.6.1地址

https:〃IP/openopi/'retrievebizlist

1.6.2功能

根据统一社会信用代玛,查询当前用户业务清单

1.6.3请求方式

POST

1.6.4请求内容

Header:{“Authorization”:token}

Body:

参数名注释

uniscid统一社会信用代码

1.6.5返回结果

"result":“OK”,

"data":[

(

"biz_name":“泰■

"biz_uuid":"Z■■,P002",

"biz_max_duration":360,

Hitem_list":[

”居民户口簿”,

“不动产抵押信息”,

”婚姻登记信息”,

”机动车行驶证”,

”不动产权证”,

“企业法人信息”,

“个人未履行生效判决信息”,

“个人诚信分(瓯江分)”,

“公积金缴存信息”,

“个人社保参保证明”

]

1.7测试

1.7.1get_token

POST|httpsK■■■「/dbfeweM/gEgkm]Save

ip找对接人员提供

YeAder,(9)Body•P«ScriptCookiesCode

•none•form-dau•x-www-form-uflencoded•raw•binary•GraphQL*0*

•civVALUCDulkedit

账号密码找对接人员提供

BodyCs(7)Status200OKTwne86roSue400BSaveRt5pome▼

Pretty13gBETAHTML▼=5返回格式

("tok«n-:

*«y3e»XA10nKVlQllC3hbGcl013IUznwn9.«y)lc2VyX21kW■,BM2YaFuAyBI«V4cC16M1U20TgxMjX«MlMib33pZ19pYXQ10JElNjk4KTAeKT>9.

>E9ElG0HT$lA4Pxqt^-8*JHSc4W«061GQ-4oy^y-Q*)|

1.7.2refreshtoken

POST▼|http"*/dbfrontend/refresh.tokenSave

Cookie%Code

▼Headers(1)

KtrDtscRirriON•••BulkEditPresets▼

AuthorUaoon|JwtlylOeXAIOlJIWIQiObGdOWUznNIJ9R1CJVpQWjOyMT.

jwt后面是一个空格,再跟上之前获汨的token

►TemporaryHeaders(8)❶

BodyCocE(7)status200OKTMnesue4160s>veResponse▼

Prwtye8nAHTML

刷新荻得的新token

("roulfiP<,-token"!

••yjecXAlO

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

评论

0/150

提交评论