［數(shù)據(jù)寶前置服務(wù)接口說明］

接口調(diào)用說明書版本：V2.2

溫州市大數(shù)據(jù)管理局

修訂記錄

修訂版本

修訂時(shí)間作者審核者修訂內(nèi)容

號(hào)

1.02021-08-17何桂清文檔創(chuàng)建

新增第三方機(jī)構(gòu)注冊(cè)、創(chuàng)建業(yè)務(wù)接

2.02021-11-26何桂清

口

2.12021-11-29何桂清接口1.5修改參數(shù)注解

接口1.5修改入?yún)?、出?新增查

2.22021-11-29何桂清

詢第三方業(yè)務(wù)清單接口

接口調(diào)用說明書目錄

接入規(guī)范.錯(cuò)誤!未定義書簽。

1.1使用說明........................................................錯(cuò)誤!未定義書簽。

1.2獲取TOKEN..…錯(cuò)誤!未定義書簽,

1.2.1ifeUt.........錯(cuò)誤!未定義書簽

1.2.2功能………錯(cuò)誤!未定義書簽

1.2.3請(qǐng)求方式錯(cuò)誤!未定義書簽,

1.2.4請(qǐng)求內(nèi)容錯(cuò)誤!未定義書簽,

1.2.5返回結(jié)果錯(cuò)誤!未定義書簽,

J/ipJ|IVxiv?????????????????????????????????????????????????????????????????????????????????????????????????|J0

1.3.1典........................................................錯(cuò)誤!未定義書簽。

132功能........................................................錯(cuò)誤!未定義書簽。

1.3.3請(qǐng)求成...................................................錯(cuò)誤!未定義書簽。

1.3.4請(qǐng)求內(nèi)容...................................................錯(cuò)誤!未定義書簽。

1.3.5返回結(jié)果...................................................錯(cuò)誤!未定義書簽。

1.4請(qǐng)求數(shù)據(jù)列表接口...............................................錯(cuò)誤!未定義書簽。

1.4.1iteilt........錯(cuò)誤!未定義書簽,

1.4.2功能.........錯(cuò)誤!未定義書簽,

1.4.3請(qǐng)求方式錯(cuò)誤!未定義書簽,

1.4.4請(qǐng)求內(nèi)容錯(cuò)誤!未定義書簽

1.4.5返回結(jié)果錯(cuò)誤!未定義書簽,

1.5第三方機(jī)構(gòu)入駐接口............................................錯(cuò)誤!未定義書簽。

1.5.1ifetlt..........錯(cuò)誤!未定義書簽,

1.5.2功能………..錯(cuò)誤!未定義書簽,

1.5.3請(qǐng)求方式..錯(cuò)誤!未定義書簽,

1.5.4請(qǐng)求內(nèi)容..錯(cuò)誤!未定義書簽,

1.5.5返回結(jié)果..錯(cuò)誤!未定義書簽

1.6測(cè)試.............................................................錯(cuò)誤!未定義書簽。

1.6.1GET_TOKEN...................................................................................錯(cuò)誤侏定義書簽。

1.6.2REFRESH.TOKEN............................................................................錯(cuò)誤!未定義書簽。

1.7錯(cuò)誤響應(yīng)碼列表.................................................錯(cuò)誤!未定義書簽。

接入規(guī)范

需要提供調(diào)用接口的服務(wù)器的對(duì)外訪問IP地址，以用于IP訪問的限制。

傳輸統(tǒng)一使用UTF-8編碼。

1.1使用說明

用戶有用戶名和密碼，使用用戶名和密碼調(diào)用接口

https://IP/openapi/get_token來獲取令牌token,也可用這個(gè)接口刷新token,

token失效后只能用這個(gè)接口重新獲取。也可在token失效前用原來的token調(diào)用接口

/IP/openapi/refreshtoken來刷新token。如果需要并發(fā)訪問的，必須將

token保存到公用區(qū)域（如redis內(nèi)存數(shù)據(jù)庫(kù)等），供并發(fā)進(jìn)程共享。否則并發(fā)進(jìn)程

之間容易發(fā)生token沖突。

username：請(qǐng)向平臺(tái)管理人員申請(qǐng)注冊(cè)。

Password：請(qǐng)向平臺(tái)管理人員申請(qǐng)注冊(cè)。

1.2獲取TOKEN

1.2.1地址

https://IP/openapi/get_token

1.2.2功能

可使用本接口來獲取token或刷新，有效期為15分鐘。

1.2.3請(qǐng)求方式

POST

1.2.4請(qǐng)求內(nèi)容

請(qǐng)求參數(shù)說明：

參數(shù)名注釋

username銀行賬號(hào)用戶名

password銀行賬號(hào)密碼

1.2.5返回結(jié)果

{“token”:〃xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx〃}

錯(cuò)誤信息：

{'error,:'xxxx,xxxx')

1.3刷新TOKEN

1.3.1地址

https://IP/openapi/refresh_token

1.3.2功能

在token秘鑰過期前，可使用本接口來刷新token,有效期為15分鐘。

1.3.3請(qǐng)求方式

POST

1.3.4請(qǐng)求內(nèi)容

請(qǐng)求參數(shù)說明：

token放在header

1.3.5返回結(jié)果

{“token”:，，xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx，，J

錯(cuò)誤信息：

{‘error*:'xxxx,xxxx'}

1.4請(qǐng)求數(shù)據(jù)列表接口

1.4.1地址

https:〃IP/openopi/'retrieveitemlist

1.4.2功能

獲取數(shù)據(jù)寶中所有在用口可以開放給其他系統(tǒng)的數(shù)據(jù)項(xiàng)清單

1.4.3請(qǐng)求方式

POST

1.4.4請(qǐng)求內(nèi)容

token放header

ParamsAuthorizationHeaders（11）Body?Pre-requestScriptTestsSettings

Headerso10hidden

KFTVALUEjwt加空格再拼接token

QAuthorizationjwteyJ0eXAiOiJ<V1QiLCJhbGciOiJIUzl1NiJ9.eyj1c2VyX2lkljo2OS,

KeyValue

Response

1.4.5返回結(jié)果

"result":"OK",

"data":（

{

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

"type":"個(gè)人證黑"，

"name":"居民戶口簿。

"template":f

"W,

“曾用名”，

“身份證號(hào)碼“，

“戶類5T,

“與戶主關(guān)系”，

“民旅”,

"出生日期"，

“出生地”，

"赫寓"

“尸修/在他”，

”所傀添出所“，

“注幅標(biāo)識(shí)”

]

},

{

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

"type":"個(gè)人證照”，

1.5第三方機(jī)構(gòu)注冊(cè)、創(chuàng)建業(yè)務(wù)接口

1.5.1地址

https:〃IP/openapi/'registerthirdparty

1.5.2功能

傳入所需參數(shù)，自動(dòng)注冊(cè)笫三方對(duì)接用戶賬號(hào)，配置權(quán)限，并創(chuàng)建業(yè)務(wù)

1.5.3請(qǐng)求方式

POST

1.5.4請(qǐng)求內(nèi)容

Header{"Authorization”:token}

ParamsAuthorizationHeaders(11)Body?Pre-requestScriptTestsSettings

Headersg10hidden

KaVALUEjwt加空格再拼接tokenOl

QAuthorizationjwteyJOeXAiOiJKV1QiLCJhbGdOiJIUzl1NiJ9.eyj1c2VyX2lkljo2OS,

Response

Body

參數(shù)名注釋

sign簽名

post_data請(qǐng)求參數(shù)（json格式字符串）

-real_name接入單位（系統(tǒng)）名稱

-uniscid接入單位（系統(tǒng)）統(tǒng)一社會(huì)信用代碼

-mobile_phone對(duì)接負(fù)責(zé)人手機(jī)號(hào)碼

-ipjimit接入TP限制，英文“；”連接

-hour_limit每小時(shí)最大訪問次數(shù)默認(rèn)1000,不超過10000

-dayjimit每天最大訪問次數(shù)默認(rèn)10000,不超過100000

-biz_max_duration業(yè)務(wù)持續(xù)時(shí)間，最長(zhǎng)不超過360,默認(rèn)30

-biz_name業(yè)務(wù)名稱

-itemjist值為L(zhǎng)4接口獲取到的數(shù)據(jù)項(xiàng)uuid列表

接入單位公鑰（1024位）不帶頭尾-----BEGIN

-pub_key

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

post_data示例,

postdata={

"real_name"："第三方接入測(cè)試賬號(hào)001"，#接入單位（系獨(dú)名稱

"uniscid":"xxxx"，#企業(yè)統(tǒng)一信用代碼證

Hmobile_phone":,#對(duì)接負(fù)責(zé)人手機(jī)號(hào)碼

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

"hour_limit":"2000",#int每小時(shí)最大訪問次致霖認(rèn)100。

"day_limit-："20000",#int每天最大訪問次數(shù)默認(rèn)10000

"biz_max_duration":"360\#業(yè)務(wù)持續(xù)時(shí)間，最長(zhǎng)不超過360,默認(rèn)30

"biz_name":"第三方楮入源試賬號(hào)001誣I試業(yè)務(wù)"，#播入業(yè)務(wù)名稱

"item_list":[

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

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

].#所需數(shù)據(jù)項(xiàng)清單，傳接口1返回的uuid集合，不超過十項(xiàng)

"pubkey":"MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQ€5rQECnWB15fB",

卜接入單位公鑰（1024位）不帶頭尾-----BEGINPUBLICKEY-----------------ENDPUBLICKEY-------

1.5.5返回結(jié)果

{"result":"success","data"：{"msg":"注冊(cè)成功"，"password":password>

1.6第三方機(jī)構(gòu)業(yè)務(wù)清單查詢接口

1.6.1地址

https:〃IP/openopi/'retrievebizlist

1.6.2功能

根據(jù)統(tǒng)一社會(huì)信用代瑪，查詢當(dāng)前用戶業(yè)務(wù)清單

1.6.3請(qǐng)求方式

POST

1.6.4請(qǐng)求內(nèi)容

Header：{“Authorization”:token}

Body：

參數(shù)名注釋

uniscid統(tǒng)一社會(huì)信用代碼

1.6.5返回結(jié)果

"result":“OK”，

"data":[

（

"biz_name":“泰■

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

"biz_max_duration":360,

Hitem_list":[

”居民戶口簿”，

“不動(dòng)產(chǎn)抵押信息”，

”婚姻登記信息”，

”機(jī)動(dòng)車行駛證”，

”不動(dòng)產(chǎn)權(quán)證”，

“企業(yè)法人信息”，

“個(gè)人未履行生效判決信息”，

“個(gè)人誠(chéng)信分（甌江分）”，

“公積金繳存信息”，

“個(gè)人社保參保證明”

]

1.7測(cè)試

1.7.1get_token

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

ip找對(duì)接人員提供

YeAder，(9)Body?P?ScriptCookiesCode

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

?civVALUCDulkedit

賬號(hào)密碼找對(duì)接人員提供

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后面是一個(gè)空格，再跟上之前獲汨的token

?TemporaryHeaders(8)?

BodyCocE(7)status200OKTMnesue4160s>veResponse▼

Prwtye8nAHTML

刷新荻得的新token

("roulfiP<，-token"!

??yjecXAlO