文化場館和旅游景區(qū)身份核驗(yàn)系統(tǒng)一卡通接口說明

報(bào)文結(jié)構(gòu)說明

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

請(qǐng)求參數(shù)說明包含以下內(nèi)容：

a）報(bào)文以JSON格式定義；

報(bào)文分為head部分和body部分;

head部分為公共部分，見表A.1,

body部分參考具體接口說明。

報(bào)文請(qǐng)求參數(shù)head部分

參數(shù)類型是否必填最大長度描述示例值

為設(shè)備所屬商戶（系統(tǒng)商）分配的應(yīng)用ID,8

appldString是8一

位字母及數(shù)字組合字符串

requestldString是16請(qǐng)求編號(hào)，數(shù)字形式一

timestampString是18時(shí)間戳，yyyyMMddHHmmssSSS一

versionString是8版本1.0

使用SM3加密，內(nèi)容為appld、

timestamp、clientSecret拼接的字符

signString是200串，符合GB/T32905-2016信息安全技術(shù)

SM3密碼雜湊算法要求。clientSecret為設(shè)

備所屬商戶（系統(tǒng)商）分配的加密KEY.

服務(wù)端會(huì)校驗(yàn)sign是否正確。

響應(yīng)參數(shù)說明

響應(yīng)參數(shù)說明包含以下內(nèi)容：

a）報(bào)文以JSON格式定義；

包體分為head部分和body部分;

head部分為公共部分，見表A.2；

body部分參考具體接U說明。

報(bào)文響應(yīng)參數(shù)head部分

參數(shù)類型是否必填最大長度描述示例值

為設(shè)備所屬商戶（系統(tǒng)商）分配的應(yīng)用ID,

appldString是8一

8位字母及數(shù)字組合字符串

requestTdSiring是16請(qǐng)求編號(hào),數(shù)字—

timestampString是18時(shí)間戳,yyyyMMddHHmmssSSS一

versionString是8版本例：1.0

使用SM3加密，內(nèi)容為appld、

timestamp%clientSecret拼接的字符串,

signString是200一

符合GB/T32905-2016信息安全技術(shù)SM3

密碼雜湊算法要求。clientSecret為設(shè)備

所屬商戶（系統(tǒng)商）分配的加密KEY

身份校驗(yàn)數(shù)據(jù)交互接口

請(qǐng)求參數(shù)

表A.3規(guī)定了個(gè)人身份核驗(yàn)數(shù)據(jù)交互接口請(qǐng)求參數(shù)。

個(gè)人身份核驗(yàn)數(shù)據(jù)交互接口請(qǐng)求參數(shù)

參數(shù)類型是否必填最大長度描述示例值

社保長使用卡識(shí)別碼，身份證使用身份證號(hào)

碼，市民卡使用卡號(hào)，電子社?？ㄊ褂枚S

qrcode_infoString是500

碼原始字符串，蘇服碼使用二維碼原始字符

串

介質(zhì)類型：

社?？ǎ?1

cardtypeString是2身份證:02

市民卡：03

二維碼（電子社?？?、蘇服碼）：04

scenic_noString是32文化場館或旅游景區(qū)編碼

設(shè)備編碼，設(shè)備的唯一編碼，字母及數(shù)字組

device_codeString是32

.A.

業(yè)務(wù)使用場景類型編號(hào)

刷住入園：1

活動(dòng)簽到：2

biz_typcString是2

圖書借閱：3

線下購票：4

（后陸續(xù)補(bǔ)充）

contact_nameString是32景區(qū)聯(lián)系人姓名

contact_phoneString是32景區(qū)聯(lián)系人手機(jī)號(hào)

user__nameString否32姓名（當(dāng)介質(zhì)類型為身份證時(shí)必填〉

9位社?？ㄌ?hào)（當(dāng)介質(zhì)類型為社保卡時(shí)必

cardnumberString否9

填）

卡規(guī)范版本（當(dāng)介質(zhì)類型為社?？〞r(shí)必

card_versionString否8例：3.00

填）

格式：

publish_dateString否18發(fā)卡日期（當(dāng)介質(zhì)類型為社?？〞r(shí)必填）

yyyyMMdd

格式：

expiry_dateString否8卡有效期（當(dāng)介質(zhì)類型為社保卡時(shí)必填）

yyyyMM

卡復(fù)位信息（當(dāng)介質(zhì)類型為社?？〞r(shí)必

cardrest_infoString否64

埔

響應(yīng)參數(shù)

表A.4規(guī)定了個(gè)人身份核驗(yàn)數(shù)據(jù)交互接口響應(yīng)參數(shù)。

個(gè)人身份核驗(yàn)數(shù)據(jù)交互接口響應(yīng)參數(shù)

參數(shù)類型是否必填最大長度描述示例值

處理結(jié)果編碼

codeString是40表示成功

I表示失敗

例：處理成

msgString是32處理結(jié)果描述

功

sinoString是32身份證號(hào)

nameString是50姓名

參保地區(qū)（到區(qū)縣），行政區(qū)劃代碼，本省卡

si_card_join_areaString否6

返回，外地卡不返回

職業(yè)（按照人社廳職業(yè)編碼），本省卡返

occupation_codeString否20

回,外地卡不返回

社?？ㄊ欠裼行?/p>

is_validString否I無效:0

有效：I

報(bào)文示例

下面給出了報(bào)文的示例。

■

"head":{

“appld":"182051110”,

“requestId":"123”,

“timeslamp":"20211124152054354〃，

version:1.0,

“sign〃：“Fl4030A0C789CCE650D5971260C6B12830A3c32EF90E53A60373

BOO

FCCLAF68F86A56850975F2CE7HEEE11600A4629485FB13EFE55F5EEBB0A

565A33334A31D”

),

“body”:(

"qrcodeinfo":"3200000101845190273800”,

“card_type":"03",

"seenic_no〃：”320117-0-LAA-02-C001〃，

"device.code*:〃NJ10022101”,

biztype:I,

“contactnam。"："王曉梅"，

“contact_phonc":"I39xxxxxxxx”,

user_name:張二,

"card.number":"123456789〃，

“cardversion":"3.00”,

〃publish_date〃：”20210504,

^expirydatc":"202505”,

card_rest_info:

)

)

■

{

“head":{

"apple":"182051110”,

“requestId":"123”,

“timestamp”:〃2020U2416()354”,

version:I.0,

"sign〃:"739FIF87B7E767C15634D1977CF523198528188F36FD654922BB7

39D

AEF7FA78844E061AD463BIF05259F603EEI90F283BI88D3AB2E4B4B35C2C3

6E2F5D615D9”

),

"body”:：

〃1〃〃八〃

code:0,

msg:success,

〃si」.o〃：,

name:張二，

si_card_join_areaz，:“320001,

"occupationcode":"020203”,

〃?〃〃八〃

is__va1l?id]:0

)

)

團(tuán)體身份校驗(yàn)數(shù)據(jù)交互接口

請(qǐng)求參數(shù)

表A.5規(guī)定了團(tuán)體身份核驗(yàn)數(shù)據(jù)交互接口請(qǐng)求參數(shù)。

團(tuán)體身份核驗(yàn)數(shù)據(jù)交互接口請(qǐng)求參數(shù)

參數(shù)類型是否必填最大長度描述示例值

社?？ㄊ褂每ㄗR(shí)別碼，身份證使用身份證號(hào)

qrcodeinfoString是500碼，市民甘使用卜號(hào)，電子社保k使用二維碼

原始字符串，蘇服碼使用二維碼原始字符串

介質(zhì)類型：

card_typcString是2

社保卡：01

身份證：02

市民卡：03

二維碼（電子社?？?、蘇服碼）：04

團(tuán)體成員身份存息，采用團(tuán)體成員姓名+身份

id_cardsString否2000

證號(hào)碼

scenic_noString是32文化場館或旅游景區(qū)編碼

devicecodeString是32設(shè)備編碼，設(shè)備的唯一編碼，字母及數(shù)字組合

業(yè)務(wù)使用場景類型編號(hào)

刷R入園：1

活動(dòng)簽到：2

biz_typeString是2

圖書借閱：3

線下購票：4

（后陸續(xù)補(bǔ)充1

contact_nameString是32景區(qū)聯(lián)系人姓名

contact_phoneString是32景區(qū)聯(lián)系人手機(jī)號(hào)

usernameString否32姓名（當(dāng)介質(zhì)類型為身份證時(shí)必填）

card_numberSiring否99位社?？ㄌ?hào)（當(dāng)介質(zhì)類型為社?？〞r(shí)必填）

card_versionString否8卡規(guī)范版本（當(dāng)介質(zhì)類型為社?？〞r(shí)必填）例：3.00

格式：

publish_dateString否18發(fā)卡H期（當(dāng)介質(zhì)類型為社保卡時(shí)必填）

yyyyMMdd

格式：

<?xpirydateString否8卡有效期（當(dāng)介質(zhì)類型為社?？〞r(shí)必填）

yyyyMM

cardrest_infoString否64卡復(fù)位信息（當(dāng)介質(zhì)類型為社?？〞r(shí)必填）

響應(yīng)參數(shù)

表A.6規(guī)定了團(tuán)體身份核驗(yàn)數(shù)據(jù)交互接口響應(yīng)參數(shù)。

團(tuán)體身份核驗(yàn)數(shù)據(jù)交互接口響應(yīng)參數(shù)

參數(shù)類型是否必填最大長度描述示例值

處理結(jié)果編碼

codeString是4

0表示成功，1表示失敗

例：處理成

msgString是32處理結(jié)果描述

功

si_noString是32身份證號(hào)

nameString是50姓名

參保地區(qū)（到區(qū)縣），行政區(qū)劃代碼，本省

si_card_join_areaString否6

卡返回，外地卡不返回

職業(yè)（按照人社廳職業(yè)編碼），本省卡返回,

occupationcodeString否20

外地卡不返回

社?？ㄊ欠裼行?/p>

is_validString否1無效：0

有效：1

報(bào)文示例

下面給出了報(bào)文的示例。

■請(qǐng)求報(bào)文

(

"head":{

"appld":"182051110〃，

"requestld":"123”,

〃Iimestamp":"20211124152054354”,

version:1.0,

"sign":"F14030A0C789CCE650D5971260C6B12830A3c32EF90E53A60373B00FCC1

AF68F86A56850975F2CE711EEE11600A4629485FB13EFE55F5EEBB0A565A33334A3

ID”

},

“body":{

"qrcode_info，，:，，3200000101845190273800\

〃card_typc":"03",

"idcards":[{"uname”:"成員1*,*id_card_no*:),

{"uname"成員2","id_card_no":},

{"uname”「成員3","id_card_no":}],

〃seenic_no"320117-0-LAA-02-0001”,

“device.code":"NJ10022101*,

biz_type:1,

“conlact_name":"王曉梅"，

“contactphon。"："139xxxxxxxx”,

user_ncime:張二，

wcard_number":"123456789”,

“cardversion":"3.00”,

*publish_date":"20210504,

*expiry_date〃：“202505〃，

card_rest_info:

}

)

■響應(yīng)報(bào)文

"head":{

“appld":"182051110〃，

“requestld":"123”,

“l(fā)imeslamp":"20201124160354〃，

version:I.0,

"sign”:"739F1F87E7F767cl5634D1977CF523198528188F36FD654922BB739DAEF

7FA78844E061AD463BIF05259F60BEE190E283B188D3AB2E4B4B35C2C36E2F5D615

D9”

},

"body":{

code:0?

〃〃〃〃

msg:success,

〃si_n。"：,

name:我二，

^sicardjoinarea*:“320001,

〃occupation_code〃：“020203”,

"?isval1i?d]":〃八0〃

}

)

實(shí)時(shí)客流數(shù)據(jù)交互接口

請(qǐng)求參數(shù)

表A.7規(guī)定了實(shí)時(shí)客流數(shù)據(jù)交互接口請(qǐng)求參數(shù)。

實(shí)時(shí)客流數(shù)據(jù)交互接口請(qǐng)求參數(shù)

是否必

參數(shù)類型最大長度描述示例值

填

scenic_noString是32文化場館或旅游景區(qū)編碼

統(tǒng)計(jì)方式

備注（后陸續(xù)補(bǔ)充）：

1、閘機(jī)

count_typeString是20

2、計(jì)嫩像頭

3、

4、閘機(jī)+計(jì)數(shù)攝像頭

5、閘大數(shù)據(jù)

6、計(jì)數(shù)攝像頭+大數(shù)據(jù)

7、閘機(jī)+計(jì)數(shù)攝像頭+大數(shù)據(jù)

8、團(tuán)入園

9、其他

統(tǒng)計(jì)范圍：

備注（后陸續(xù)補(bǔ)充）：

count_rangeString是20

1、全文化場館或旅游景區(qū)

2、園中園

小景區(qū)名稱

sccnic_nameString否60

當(dāng)統(tǒng)計(jì)范圍為類型2的時(shí)候,本項(xiàng)必填

格式：

count_dateString是8統(tǒng)計(jì)日期

yyyyMMdd

格式：

count_timcString是16統(tǒng)計(jì)時(shí)間yyyyMMddHHmm

SS

格式：

begin_timeString否16當(dāng)前時(shí)段進(jìn)園人數(shù)統(tǒng)計(jì)開始時(shí)間

yyyyMMddHHnmss

格式：

end_timeString否16當(dāng)前時(shí)段進(jìn)園人數(shù)統(tǒng)計(jì)結(jié)束時(shí)間

yyyyMMddHHnmss

currcnt_into_numbcrint否8當(dāng)前時(shí)段累計(jì)進(jìn)園人數(shù)（單位:人次）

inlo_numberini是8當(dāng)天累計(jì)進(jìn)園人數(shù)（單位:人次）

outnumberint否8當(dāng)天累計(jì)出園人數(shù)（單位：人次）

staynumberint否8實(shí)時(shí)在園人數(shù)（單位：人數(shù)）

響應(yīng)參數(shù)

表A.8規(guī)定了實(shí)時(shí)客流數(shù)據(jù)交互接口響應(yīng)參數(shù)。

實(shí)時(shí)客流數(shù)據(jù)交互接口響應(yīng)參數(shù)

參數(shù)類型是否必填最大長度描述示例值

處理結(jié)果編碼

codeString是4

0表示成功，1表示失敗

例：處理成

usgString矮32處理結(jié)果描述

功

報(bào)文示例

卜?面給出了報(bào)文的示例。

“head":{

“appld":"182051110”,

“requestId":"123”,

"timestamp":〃202()1124152054”,

version:1.0,

“sign〃：〃F14030A0C789CCE650D5971260C6B12830A3C32EF90E53A60373BOOFC

C

1AF68F86A56850975F2CE711EEE11600A4629485FB13EFE55F5EEBB0A565A3333

4A31D〃

},

“body":{

seenic_no"<320117-0-LAA-02-000K,

count-type:1,

〃〃"八〃

count_range:2,

“scenic_name":"xxxx",

"count_d&te":"20210121”,

"count_time":"20210121131401〃，

"begin_t加。"："20210121093001”,

〃end_time":"20210121113000”,

''currentintonumber”:5,

“into_number”:20,

“out_num匕er”:10,

“staynumber”:160

)

■文

“head":{

“appld":"182051110”,

“requestId":"123”,

“timestamp":"20201124160354”,

version:1.0,

“sign〃:〃739F1F87E7F767C156341)1977CF523198528188F36FD654922BB739DA

EF7

FA78844E061AD463B1F05259F60BEE190F283B188D3AB2E4B4B35c2c36E2F5D61

5D9”

},

“body":{

code:0,

msg:success

)

}

預(yù)約數(shù)據(jù)交互接口

請(qǐng)求參數(shù)

表A.9規(guī)定了預(yù)約數(shù)據(jù)交互接口請(qǐng)求參數(shù)。

預(yù)約數(shù)據(jù)交互接口請(qǐng)求參數(shù)

參數(shù)類型是否必填最大長度描述示例值

scenic_noString是32文化場館或旅游景區(qū)編碼

orderdateString是8預(yù)約日期

begintimeString是16時(shí)間段開始時(shí)間（預(yù)約入園開始時(shí)間）

end_timeString是16時(shí)間段結(jié)束時(shí)間（預(yù)約入園結(jié)束時(shí)間）

當(dāng)前時(shí)間段文化場館或旅游景區(qū)最大承

lolal_numberint是8

載量

already_booked_numberint是8當(dāng)前時(shí)間段已預(yù)約數(shù)量

surplus_numberint是8當(dāng)前時(shí)間段剩余可預(yù)約數(shù)量

響應(yīng)參數(shù)

表A.10規(guī)定了預(yù)約數(shù)據(jù)交互接口響應(yīng)參數(shù)。

預(yù)約數(shù)據(jù)交互接口響應(yīng)參數(shù)

參數(shù)類型是否必填最大長度描述示例值

處理結(jié)果編碼

codeString是4

0表示成功，I表示失敗

例：處理成

msgString是32處理結(jié)果描述

功

報(bào)文示例

下面給出了報(bào)文的示例。

■

(

"head":{

"appld":"182051110”,

“requestId":"123”,

“t加estamp":"20211124152054354〃，

version:I.0,

〃sign〃：“F14030A0C789CCE650D5971260C6B12830A3C32EF90E53A60373BG0FC

C

1AF68F86A56850975F2CE7HEEEll600A4629485FBI3EFE55F5EEBB0A565A3333

4A3ID"

),

“body”:[

(

〃scenic_n。”<320117-0-LAA-02-0001".

“order_cale〃：“20211202”,

，zbegin_time":"20211202093000”,

"end_time":"20211202113000”,

“total_numer”:500,

“a1ready_booked_number,/:223.

“surplus_number”:277

},

(

“scenijno":"320117-0-LAA-02-0001”,

“ordejcate":"20211202”,

“begin_time":"20211202100000”,

〃end_tinie":"20211202120000〃，

“total_numer”:500,

“a1ready_booked_number”:223,

“surplusjiumber”:277

}

]

)

■

(

“head":{

“appld":"182051110”,

“requestld":"123",

"timeslamp":"20201124160354〃，

version:I.0,

"sign":"739FIF87E7F767C15634D1977CF523198528188F36FD654922BB739DA

EF7

FA78844E06IAD463BIF05259F60BEEI90F283B188D3AB2E4B4B35C2C36E2F5D6I

5D9”

),

“body":{

code:0,

"msg":"success”

)

}

文化場館和旅游景區(qū)開放狀態(tài)數(shù)據(jù)交互接口

請(qǐng)求參數(shù)

表A.11規(guī)定了文化場館和旅游景區(qū)狀態(tài)數(shù)據(jù)交互接口請(qǐng)求參數(shù)。