文化场馆和旅游景区身份核验系统一卡通接口说明

文化场馆和旅游景区身份核验系统一卡通接口说明

报文结构说明

请求参数说明

请求参数说明包含以下内容：

a）报文以JSON格式定义；

报文分为head部分和body部分;

head部分为公共部分，见表A.1,

body部分参考具体接口说明。

报文请求参数head部分

参数类型是否必填最大长度描述示例值

为设备所属商户（系统商）分配的应用ID,8

appldString是8一

位字母及数字组合字符串

requestldString是16请求编号，数字形式一

timestampString是18时间戳，yyyyMMddHHmmssSSS一

versionString是8版本1.0

使用SM3加密，内容为appld、

timestamp、clientSecret拼接的字符

signString是200串，符合GB/T32905-2016信息安全技术

SM3密码杂凑算法要求。clientSecret为设

备所属商户（系统商）分配的加密KEY.

服务端会校验sign是否正确。

响应参数说明

响应参数说明包含以下内容：

a）报文以JSON格式定义；

包体分为head部分和body部分;

head部分为公共部分，见表A.2；

body部分参考具体接U说明。

报文响应参数head部分

参数类型是否必填最大长度描述示例值

为设备所属商户（系统商）分配的应用ID,

appldString是8一

8位字母及数字组合字符串

requestTdSiring是16请求编号,数字—

timestampString是18时间戳,yyyyMMddHHmmssSSS一

versionString是8版本例：1.0

使用SM3加密，内容为appld、

timestamp%clientSecret拼接的字符串,

signString是200一

符合GB/T32905-2016信息安全技术SM3

密码杂凑算法要求。clientSecret为设备

所属商户（系统商）分配的加密KEY

身份校验数据交互接口

请求参数

表A.3规定了个人身份核验数据交互接口请求参数。

个人身份核验数据交互接口请求参数

参数类型是否必填最大长度描述示例值

社保长使用卡识别码，身份证使用身份证号

码，市民卡使用卡号，电子社保卡使用二维

qrcode_infoString是500

码原始字符串，苏服码使用二维码原始字符

串

介质类型：

社保卡：01

cardtypeString是2身份证:02

市民卡：03

二维码（电子社保卡、苏服码）：04

scenic_noString是32文化场馆或旅游景区编码

设备编码，设备的唯一编码，字母及数字组

device_codeString是32

.A.

业务使用场景类型编号

刷住入园：1

活动签到：2

biz_typcString是2

图书借阅：3

线下购票：4

（后陆续补充）

contact_nameString是32景区联系人姓名

contact_phoneString是32景区联系人手机号

user__nameString否32姓名（当介质类型为身份证时必填〉

9位社保卡号（当介质类型为社保卡时必

cardnumberString否9

填）

卡规范版本（当介质类型为社保卡时必

card_versionString否8例：3.00

填）

格式：

publish_dateString否18发卡日期（当介质类型为社保卡时必填）

yyyyMMdd

格式：

expiry_dateString否8卡有效期（当介质类型为社保卡时必填）

yyyyMM

卡复位信息（当介质类型为社保卡时必

cardrest_infoString否64

埔

响应参数

表A.4规定了个人身份核验数据交互接口响应参数。

个人身份核验数据交互接口响应参数

参数类型是否必填最大长度描述示例值

处理结果编码

codeString是40表示成功

I表示失败

例：处理成

msgString是32处理结果描述

功

sinoString是32身份证号

nameString是50姓名

参保地区（到区县），行政区划代码，本省卡

si_card_join_areaString否6

返回，外地卡不返回

职业（按照人社厅职业编码），本省卡返

occupation_codeString否20

回,外地卡不返回

社保卡是否有效

is_validString否I无效:0

有效：I

报文示例

下面给出了报文的示例。

■

"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

)

)

团体身份校验数据交互接口

请求参数

表A.5规定了团体身份核验数据交互接口请求参数。

团体身份核验数据交互接口请求参数

参数类型是否必填最大长度描述示例值

社保卡使用卡识别码，身份证使用身份证号

qrcodeinfoString是500码，市民甘使用卜号，电子社保k使用二维码

原始字符串，苏服码使用二维码原始字符串

介质类型：

card_typcString是2

社保卡：01

身份证：02

市民卡：03

二维码（电子社保卡、苏服码）：04

团体成员身份存息，采用团体成员姓名+身份

id_cardsString否2000

证号码

scenic_noString是32文化场馆或旅游景区编码

devicecodeString是32设备编码，设备的唯一编码，字母及数字组合

业务使用场景类型编号

刷R入园：1

活动签到：2

biz_typeString是2

图书借阅：3

线下购票：4

（后陆续补充1

contact_nameString是32景区联系人姓名

contact_phoneString是32景区联系人手机号

usernameString否32姓名（当介质类型为身份证时必填）

card_numberSiring否99位社保卡号（当介质类型为社保卡时必填）

card_versionString否8卡规范版本（当介质类型为社保卡时必填）例：3.00

格式：

publish_dateString否18发卡H期（当介质类型为社保卡时必填）

yyyyMMdd

格式：

<?xpirydateString否8卡有效期（当介质类型为社保卡时必填）

yyyyMM

cardrest_infoString否64卡复位信息（当介质类型为社保卡时必填）

响应参数

表A.6规定了团体身份核验数据交互接口响应参数。

团体身份核验数据交互接口响应参数

参数类型是否必填最大长度描述示例值

处理结果编码

codeString是4

0表示成功，1表示失败

例：处理成

msgString是32处理结果描述

功

si_noString是32身份证号

nameString是50姓名

参保地区（到区县），行政区划代码，本省

si_card_join_areaString否6

卡返回，外地卡不返回

职业（按照人社厅职业编码），本省卡返回,

occupationcodeString否20

外地卡不返回

社保卡是否有效

is_validString否1无效：0

有效：1

报文示例

下面给出了报文的示例。

■请求报文

(

"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:

}

)

■响应报文

"head":{

“appld":"182051110〃，

“requestld":"123”,

“limeslamp":"20201124160354〃，

version:I.0,

"sign”:"739F1F87E7F767cl5634D1977CF523198528188F36FD654922BB739DAEF

7FA78844E061AD463BIF05259F60BEE190E283B188D3AB2E4B4B35C2C36E2F5D615

D9”

},

"body":{

code:0?

〃〃〃〃

msg:success,

〃si_n。"：,

name:我二，

^sicardjoinarea*:“320001,

〃occupation_code〃：“020203”,

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

}

)

实时客流数据交互接口

请求参数

表A.7规定了实时客流数据交互接口请求参数。

实时客流数据交互接口请求参数

是否必

参数类型最大长度描述示例值

填

scenic_noString是32文化场馆或旅游景区编码

统计方式

备注（后陆续补充）：

1、闸机

count_typeString是20

2、计嫩像头

3、

4、闸机+计数摄像头

5、闸大数据

6、计数摄像头+大数据

7、闸机+计数摄像头+大数据

8、团入园

9、其他

统计范围：

备注（后陆续补充）：

count_rangeString是20

1、全文化场馆或旅游景区

2、园中园

小景区名称

sccnic_nameString否60

当统计范围为类型2的时候,本项必填

格式：

count_dateString是8统计日期

yyyyMMdd

格式：

count_timcString是16统计时间yyyyMMddHHmm

SS

格式：

begin_timeString否16当前时段进园人数统计开始时间

yyyyMMddHHnmss

格式：

end_timeString否16当前时段进园人数统计结束时间

yyyyMMddHHnmss

currcnt_into_numbcrint否8当前时段累计进园人数（单位:人次）

inlo_numberini是8当天累计进园人数（单位:人次）

outnumberint否8当天累计出园人数（单位：人次）

staynumberint否8实时在园人数（单位：人数）

响应参数

表A.8规定了实时客流数据交互接口响应参数。

实时客流数据交互接口响应参数

参数类型是否必填最大长度描述示例值

处理结果编码

codeString是4

0表示成功，1表示失败

例：处理成

usgString矮32处理结果描述

功

报文示例

卜•面给出了报文的示例。

“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

)

}

预约数据交互接口

请求参数

表A.9规定了预约数据交互接口请求参数。

预约数据交互接口请求参数

参数类型是否必填最大长度描述示例值

scenic_noString是32文化场馆或旅游景区编码

orderdateString是8预约日期

begintimeString是16时间段开始时间（预约入园开始时间）

end_timeString是16时间段结束时间（预约入园结束时间）

当前时间段文化场馆或旅游景区最大承

lolal_numberint是8

载量

already_booked_numberint是8当前时间段已预约数量

surplus_numberint是8当前时间段剩余可预约数量

响应参数

表A.10规定了预约数据交互接口响应参数。

预约数据交互接口响应参数

参数类型是否必填最大长度描述示例值

处理结果编码

codeString是4

0表示成功，I表示失败

例：处理成

msgString是32处理结果描述

功

报文示例

下面给出了报文的示例。

■

(

"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”

)

}

文化场馆和旅游景区开放状态数据交互接口

请求参数

表A.11规定了文化场馆和旅游景区状态数据交互接口请求参数。