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

文化场馆和旅游景区身份核验系统一卡通接口说明报文结构说明请求参数说明请求参数说明包含以下内容：a）报文以JSON格式定义；报文分为head部分和body部分；head部分为公共部分，见表A.1；body部分参考具体接口说明。报文请求参数head部分参数类型是否必填最大长度描述示例值appletString是8为设备所属商户（系统商）分配的应用ID,8位字母及数字组合字符串requestIdString是16请求编号，数字形式timestampString是18时间戳，YyyyMMddHHmmssSSS一versionString是8版本1.0signString是200使用SM3加密，内容为appld、timestamp、ClientSecret拼接的字符串，符合GB/T32905-2016信息安全技术SM3密码杂凑算法要求。CIientSeCret为设备所属商户（系统商）分配的加密KEYo服务端会校验sign是否正确。响应参数说明响应参数说明包含以下内容：a）报文以JSoN格式定义；包体分为head部分和body部分;head部分为公共部分,见表A.2；body部分参考具体接口说明。报文响应参数head部分参数类型是否必填最大长度描述示例值appldString是8为设备所属商户（系统商）分配的应用ID,8位字母及数字组合字符串一requestldString是16请求编号，数字一timestampString是18时间戳，YyyyMMddHHmmssSSS一versionString是8版本例：LOsignString是200使用SM3加密，内容为appld、timestamp»clientSecret拼接的字符串，符合GB/T32905-2016信息安全技术SM3密码杂凑算法要求。ClientSecret为设备所属商户（系统商）分配的加密KEY身份校验数据交互接口请求参数表A.3规定了个人身份核验数据交互接口请求参数。个人身份核验数据交互接口请求参数参数类型是否必填最大长度描述示例值qrcode_infoString是500社保卡使用卡识别码，身份证使用身份证号码，市民卡使用卡号，电子社保卡使用二维码原始字符串，苏服码使用二维码原始字符串cardtypeString是2介质类型：社保卡：01身份证：02市民卡：03二维码（电子社保卡、苏服码）：04SCenijnoString是32文化场馆或旅游景区编码device_codeString是32设备编码，设备的唯编码，字母及数字组合biz_typeString是2业务使用场景类型编号国冰入园：1活动签到：2图书借阅：3线下购票：4（后陆续补充）contact_nameString是32景区联系人姓名contactphoneString是32景区联系人手机号user_nameString否32姓名（当介质类型为身份证时必填）card_numberString否99位社保卡号（当介质类型为社保卡时必网）card_versionString否8K规范版本（当介质类型为社保卡时必填）例：3.00publish_dateString否18发卡日期（当介质类型为社保卡时必填）格式：yyyyMMddexpirydateString否8卡有效期（当介质类型为社保卡时必填）格式：yyyyMMcard_rest_infoString否64卡复位信息（当介质类型为社保卡时必填）响应参数表A.4规定了个人身份核验数据交互接口响应参数。个人身份核验数据交互接口响应参数参数类型是否必填最大长度描述示例值codeString是4处理结果编码0表示成功1表示失败msgString是32处理结果描述例：处理底功SinOString是32身份证号nameString是50姓名si_card_join_areaString否6参保地区侄岖县），行政区划代码，本省卡返回，外地卡不返回occupation_codeString否20职业（按照人社厅职业编码），本省卡返回，外地卡不返回is_validString否1社保卡是否有效无效：0有效：1报文示例下面给出了报文的示例。三S“head":,appldzz182051HO",“requested”:123”,“timestamp":"20211124152054354”,tversion:1.0,*sign*:*F14030A0C789CCE650D5971260C6B12830A3C32EF90E53A60373BOOFCC1AF68F86A56850975F2CE71IEEEl1600A4629485FB13EFE55F5EEBB0A565A33334A31D”,"body":*qrcode_info*,3200000101845190273800，"card_type":"03","seenic_no":"320117-0-L-02-0001”,“device_code"NJ1002210,biz_type:1,z,contactname":"王晓梅"，“contact_PhOne":"139XXXXXXxx”,user_name:张二,“cardnumber":"123456789”,“careLVerSiOn":"3.00”,"publish_date”:20210504,“expiry_date":"202505”,cardrestinfo:)(“head":“appld":"182051110，“requestId":"123”,"timestamp":"20201124160354”,.""re"version:1.0,"sign":"739F1F87E7F767C15634D1977CF523198528188F36FD654922BB739DEE7F78844E061AD463B1E05259F60BEE190F283B188D3B2E4B4B35C2C36E2F5D615D9”),"body":code:0,msg:success,"si_no":"320111197010153465”,name:张二，“si_card_join_area":"320001,“occupationCOde":"020203”,s-vald:0)团体身份校验数据交互接口请求参数表A.5规定了团体身份核验数据交互接口请求参数。团体身份核验数据交互接口请求参数参数类型是否必填最大长度描述示例值qrcodeinfoString是500社保卡使用卡识别码，身份证使用身份证号码，市民卡使用卡号，电子社保卡使用二维码原始字符串，苏服码使用二维码原始字符串card_typeString是2介质类型：社保卡：Ol身份证：02市民卡：03二维码（电子社保卡、苏服码）：04id_cardsString否2000团体成员身份信息，采用团体成员姓名+身份证号码SCCniJnoString是32文化场馆或旅游景区编码device_codeString是32设备编码，设备的唯一编码，字母及数字组合biz_typeString是2业务使用场景类型编号刷卡入园：1活动签到：2图书借阅：3线下购票：4（后陆续补充）contactnameString是32景区联系人姓名contactphoneString是32景区联系人手机号user_nameString否32姓名（当介质类型为身份证时必填）card_numberString否99位社保卡号（当介质类型为社保卡时必填）card_versionString否8卡规范版本（当介质类型为社保卡时必填）例：3.00publish_dateString否18发卡日期（当介质类型为社保卡时必填）格式：VyyyMMddexpirydateString否8卡有效期（当介质类型为社保卡时必填）格式：yyyyMMcardrestinfoString否64卡复位信息（当介质类型为社保卡时必填）响应参数表A.6规定了团体身份核验数据交互接口响应参数。团体身份核验数据交互接口响应参数参数类型是否必填最大长度描述示例值codeString是4处理结果编码0表示成功，1表示失败nsgString是32处理结果描述例：处理成功si_noString是32身份证号nameString是50姓名si_card_join_areaString否6参保地区（到区县），行政区划代码，本省卡返回，外地卡不返回occupation_codeString否20职业（按照人社厅职业编码），本省卡返回,外地卡不返回is_validString否1社保卡是否有效无效：0有效：1报文示例下面给出了报文的示例。请求报文("head":appId：182051U0，“requestld”:123，"timestamp":"20211124152054354”,八version:1.0,zsign,rF14030A0C789CCE650D5971260C6B12830A3C32EF90E53A60373B00FCClAF68F86A56850975F2CE71IEEEll600A4629485FB13EFE55F5EEBB0A565A33334A31D,"body":"qrcode.info":"3200000101845190273800",“card_type:“03，“id_cards":"uname":"成员1","id_carCLnO":"320111196911012610",“uname”:"成员2","id_card_no":"320111199510052618","uname":成员3","id_card_no"/320111199802162629*),"seenic_no"/320117-0-LAA-02-000/,“device_code*:"NJ1002210/,biztype:I,"contact_name":"王晓梅"，“contact_phone":"139XXXXXXXx”,user_name:张二，*card_number":"123456789”,yzcard-version":"3.00”,，zpublish_date":，z20210504,"expiry_date":"202505”,ICcaro_rest_info:响应报文“head":“appld":"182051110，“requestld”:123，“timestamp":"20201124160354”,“0八version:1.0,zsign,739FlF87E7F767C15634D1977CF523198528188F36FD654922BB739DAEF7FA78844E061AD463B1F05259F60BEE19OF283B188D3AB2E4B4B35C2C36E2F5D615D9),"body":code:0,msg:success,"si_no":,320111197010153465",name:张二，si_card_join_area：“320001,yrOccupation-Code*:"020203”,is_valid:0)实时客流数据交互接口请求参数表A.7规定了实时客流数据交互接口请求参数。实时客流数据交互接口请求参数参数类型是否必填最大长度描述示例值SCeniJnOString是32文化场馆或旅游景区编码counttypeString是20统计方式备注（后陆续补充）：1、闸机2、计数摄像头3、4、闸机计数摄像头5、闸机大数据6、计数摄像头+大数据7、闸机+计数摄像头+大数据8、腑9、其他count_rangeString是20统计范围：备注（后陆续补充）：1、全文化场馆或旅游景区2、园中园ScenijnameString否60小景区名称当统计范围为类蛰2的时候,本项必填count_dateString是8统计日期格式：yyyyMMddcount_timeString是16统计时间格式：YyyyMMddHHnunSSbegintimeString否16当前时段进园人数统计开始时间格式：yyyyMMddHHmmssend_timeString否16当前时段进园人数统计结束时间格式：yyyyMMddHHmmsscurrent_into_numberint否8当前时段累计进园人数（单位:人次）into_numberim是8当天累计进园人数（单位:人次）OUjnUmberint否8当天累计出园人数（单位：人次）staynumberint否8实时在园人数（单位：人数）响应参数表A.8规定了实时客流数据交互接口响应参数。实时客流数据交互接口响应参数参数类型是否必填最大长度描述示例值codeString是4处理结果编码0表示成功，1表示失败nsgString是32处理结果描述例：处理成功报文示例下面给出了报文的示例。"head":“appld":"182051HO”,requestIdz,xzl23z,“timestamp":"20201124152054”,version:1.0,"sign":z,F14030A0C789CCE650D5971260C6B12830A3C32EF90E53A60373B00FCC1AF68F86A56850975F2CE71IEEEll600A4629485FB13EFE55F5EEBB0A565A33334A31D”),“body：“sceniJno”:,320117-0-LAA-02-0001",CoUnt_type:1,count_range:2,“sceniCname":"xxxx","count_date：“20210121”,"c。Unt"20210121131401”,"begin_time：“20210121093001”,"end_time":"20210121113000”,z,current-intonumberz,:5,“intonumber”:20,“outnumber”:10,z,staynumberz,:160)saft:fI"head":“appId”J182051110”,"requestld":"123”,“timestamp":"20201124160354”,version:1.0,sign,739ElF87E7E767C15634D1977CF523198528188F36FD654922BB739DAEF7F78844E061D463B1F05259F60BEE190F283B188D3AB2E4B4B35C2C36E2E5D615D9”),"body":I八code:0,/Hmsg:success)预约数据交互接口请求参数表A.9规定了预约数据交互接口请求参数。预约数据交互接口请求参数参数类型是否必填最大长度描述示例值ScenijnoString是32文化场馆或旅游景区编码OrdejdateString是8预约日期begintimeString是16时间段开始时间（预约入园开始时间）end_timeString是16时间段结束时间（预约入园结束时间）total_numberint是8当前时间段文化场馆或旅游景区最大承载量a1ready_booked_numberint是8当前时间段已预约数量SUrPlUS.numberint是8当前时间段剩余可预约数量响应参数表A.10规定了预约数据交互接口响应参数。预约数据交互接口响应参数参数类型是否必填最大长度描述示例值codeString是4处理结果编码0表示成功，1表示失败nsgString是32处理结果描述例：处理成功报文示例下面给出了报文的示例。I"head":“appId”J182051H(,“requestld":"123”,"timestamp":"20211124152054354，version:1.0,sign"T14030A0C789CCE650D5971260C6B12830A3C32EF90E53A60373B00FCC1AF68F86A56850975F2CE71IEEEll600A4629485FB13EFE55F5EEBB0A565A33334A31D""body”:(“sceniJno”<320117-0-LAA-02-000,“ordeJdate：20211202”,"begin_time：“20211202093000”,“end_time",20211202113000z,z,total-numerz,:500,alreadybookednumber*:223,z,surplusnumberz,:277,(“sceniCJo”<320117-0-LAA-02-000,“ordeJdate":20211202”,"begin_time*/202112021OOoO0，"endtime":"20211202120000",zrtotal-numerz,:500,alreadybookednumberz,:223,“surplUSnUmber:277)("head":“appld":"182051110，“requestld":"123”,"timestamp"："20201124160354",1八version:I.0,sign",739FlF87E7F767Cl5634Dl977CF523l98528l88F36FD654922BB739DAEF7FA78844E06IAD463BlF05259F60BEEl90F283Bl88D3AB2E4B4B35C2C36E2F5D6I5D9),“body":code:0,/msg:success)文化场馆和旅游景区开放状态数据交互接口请求参数表A.11规定了文化场馆和旅游景区状态数据交互接口请求参数。文化场馆和旅游景区状态数据交互接口请求参数参数类型是否必填最大长度描述示例值scenic_noString是32文化场馆或旅游景区编码rcport_dateString是8统计日期格式：yyyyMMddbegintimeString是16统计时间段开始时间格式：yyyyMMddHHmmsscnd_timeString是16统计时间段结束时间格式：yyyyMMddHHmmssstatusString是2景区状态0：闭园1:正常开放2:限流预警3:暂停入园4:特殊开放日（待补充）响应参数表A.12规定了文化场馆和旅游景区状态数据交互接口响应参数。文化场馆和旅游景区状态数据交互接口响应参数参数类型是否必填最大长度描述示例值codeString是4处理结果编码0表示成功，si表示失败msgString是32处理结果描述处理成功报文示例下面给出了报文的示例"head":z,appld,182051110","requestld":"123”,"timestamp”<20211124152054354”,version:1.0,"sign":,F14030A0C789CCE650D5971260C6B12830A3C32EF90E53A60373B00FCC1AE68F865685O975E2CE71IEEEl16004629485EB13EFE55F5EEBB0565A3333431Dz,"body":"scenijno":"320117-0-LAA-O2-0001”,“report.date":"20210121”,"startjime":"20210121090000，“endime":"20210121170000,“status”:T"head":“appld":"182051110，“requestld”:123，"timestamp"："20201124160354,z,十八version:1.0,zzsign",739FlF87E7F767C15634D1977CF523198528188F36FD654922BB739DAEF7FA78844E061AD463B1F05259F60BEE190F283B188D3AB2E4B4B35C2C36E2F5D615D9,"body":code:0,“msg:success