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

文化场馆和旅游景区身份核验系统一卡通接口说明报文结构说明请求参数说明请求参数说明包含以下内容：报文以JSON格式定义；报文分为head部分和body部分；head部分为公共部分，见表A.1；body部分参考具体接口说明。报文请求参数head部分appIdString是8ID，8串--requestIdString是16字形式--timestampString是18yyyyMMddHHmmssSSS--versionString是81.0signString是200SM3appId、timestamp、clientSecret拼接的字符串,符合GB/T32905-2016信息安全技术SM3密码杂凑算法要求。clientSecret为设备所属商户(系统商)分配的加密KEY。--服务端会校验sign是否正确。响应参数说明响应参数说明包含以下内容：报文以JSON格式定义；包体分为head部分和body部分；head部分为公共部分,见表A.2；body部分参考具体接口说明。报文响应参数head部分appIdString是8ID，8--requestIdString是16字--timestampString是18yyyyMMddHHmmssSSS--versionString是81.0signString是200使用SM3加密，内容为appId、timestamp、clientSecret拼接的字符串，符合GB/T32905-2016信息安全技术SM3密码杂凑算法要求。clientSecret为设备所属商户(系统商)分配的加密KEY--身份校验数据交互接口请求参数表A.3规定了个人身份核验数据交互接口请求参数。个人身份核验数据交互接口请求参数qrcode_infoString是500card_typeString是201020304scenic_noString是32编码device_codeString是32biz_typeString是2号动签到：23票：4(后陆续补充)contact_nameString是32景区联系人姓名contact_phoneString是32景区联系人手机号user_nameString否32姓名（当介质类型为身份证时必填）card_numberString否99card_versionString否8卡规范版本(当介质类型为社保卡时例：3.00publish_dateString否18发卡日期(当介质类型为社保卡时必格式：yyyyMMddexpiry_dateString否8卡有效期(当介质类型为社保卡时必格式：yyyyMMcard_rest_infoString否64卡复位信息(当介质类型为社保卡时响应参数表A.4规定了个人身份核验数据交互接口响应参数。个人身份核验数据交互接口响应参数codeString是40表示成功1msgString是32si_noString是32nameString是50si_card_join_areaString否6卡不返回occupation_codeString否20职业(按照人社厅职业编码)，本省is_validString否1无效：0有效：1报文示例下面给出了报文的示例。{Idampqrcodeinfo00101845190273800",typescenicnoLAA001"，}}{"head":{tIdtimestampionsignFFEF7C15634D1977CF523198528188F36FD654922BB739DAEFFAEADBF5259F60BEE190F283B188D3AB2E4B4B35C2C"body":{esssicardjoinarea1,occupationcode"，}}团体身份校验数据交互接口请求参数表A.5规定了团体身份核验数据交互接口请求参数。团体身份核验数据交互接口请求参数参数类型是否必填最大长度描述示例值qrcode_infoString是500社保卡使用卡识别码，身份证使用身份证号码，市民卡使用卡号，电子社保卡使用二维码原始字符串，苏服码使用二维码原始字符串card_typeString是2介质类型：社保卡：01身份证：02市民卡：03二维码（电子社保卡、苏服码）：04id_cardsString否2000团体成员身份信息,采用团体成员姓名+身份证号码scenic_noString是32文化场馆或旅游景区编码device_codeString是32设备编码，设备的唯一编码，字母及数字组合biz_typeString是2业务使用场景类型编号

刷卡入园：1活动签到：2图书借阅：3线下购票：4（后陆续补充）contact_nameString是32景区联系人姓名contact_phoneString是32景区联系人手机号user_nameString否32姓名（当介质类型为身份证时必填）card_numberString否99位社保卡号（当介质类型为社保卡时必填）card_versionString否8卡规范版本（当介质类型为社保卡时必填）例：3.00publish_dateString否18发卡日期（当介质类型为社保卡时必填）格式：yyyyMMddexpiry_dateString否8卡有效期（当介质类型为社保卡时必填）格式：yyyyMMcard_rest_infoString否64卡复位信息（当介质类型为社保卡时必填）响应参数表A.6规定了团体身份核验数据交互接口响应参数。团体身份核验数据交互接口响应参数参数类型是否必填最大长度描述示例值codeString是4处理结果编码0表示成功，1表示失败msgString是32处理结果描述例：处理成功si_noString是32身份证号nameString是50姓名si_card_join_areaString否6参保地区（到区县），行政区划代码，本省卡返回，外地卡不返回occupation_codeString否20职业（按照人社厅职业编码），本省卡返回，外地卡不返回is_validString否1社保卡是否有效无效：0有效：1报文示例下面给出了报文的示例。请求报文{"head":{"appId":"182051110","requestId":"123","timestamp":"20211124152054354","version":"1.0","sign":"F14030A0C789CCE650D5971260C6B12830A3C32EF90E53A60373B00FCC1AF68F86A56850975F2CE711EEE11600A4629485FB13EFE55F5EEBB0A565A33334A31D"},"body":{"qrcode_info":"3200000101845190273800","card_type":"03","id_cards":[{"uname":"成员1","id_card_no":},{"uname":"成员2","id_card_no":},{"uname":"成员3","id_card_no":}],"scenic_no":"320117-0-LAA-02-0001"，"device_code":"NJ10022101"，"biz_type":"1"，"contact_name":"王晓梅","contact_phone":"139xxxxxxxx","user_name":"张三","card_number":"123456789"，"card_version":"3.00"，"publish_date":"20210504,"expiry_date":"202505"，"card_rest_info":""}}响应报文{"head":{"appId":"182051110", "requestId":"123", "timestamp":"20201124160354", "version":"1.0","sign":"739F1F87E7F767C15634D1977CF523198528188F36FD654922BB739DAEF7FA78844E061AD463B1F05259F60BEE190F283B188D3AB2E4B4B35C2C36E2F5D615D9"},"body":{"code":"0","msg":"success","si_no":,"name":"张三","si_card_join_area":"320001, "occupation_code":"020203"， "is_valid":"0"}}实时客流数据交互接口请求参数表A.7规定了实时客流数据交互接口请求参数。实时客流数据交互接口请求参数scenic_noString编码count_typeString备注(后陆续补充)：12345678count_rangeString备注(后陆续补充)：12scenic_nameString2count_dateString：yyyyMMddcount_timeString：yyyyMMddHHmmssbegin_timeString16当前时段进园人数统计开始时间格式：yyyyMMddHHmmssend_timeString16当前时段进园人数统计结束时间格式：yyyyMMddHHmmsscurrent_into_numberintinto_numberintout_numberintstay_numberint响应参数表A.8规定了实时客流数据交互接口响应参数。实时客流数据交互接口响应参数codeString报文示例下面给出了报文的示例。{IdmestampsignFAC9CCE650D5971260C6B12830A3C32EF90E53A60373B00FCCAFFAFCEEEEAFBEFEFEEBBAA33334A31D"scenicno",ypengeamexxxxcountdate",ounttimetimetimeerererber}}{"head":{tIdtimestamp",nsignFFEFC5634D1977CF523198528188F36FD654922BB739DAEF7FAEADBF59F60BEE190F283B188D3AB2E4B4B35C2C36E2F5D6msgsuccess"}}预约数据交互接口请求参数表A.9规定了预约数据交互接口请求参数。预约数据交互接口请求参数scenic_noString编码order_dateStringbegin_timeStringend_timeStringtotal_numberint当前时间段最大承载量already_booked_numberint当前时间段已预约数量surplus_numberint响应参数表A.10规定了预约数据交互接口响应参数。预约数据交互接口响应参数codeString01msgString处理结果描述例：处理成功报文示例下面给出了报文的示例。{IdampsignFAC9CCE650D5971260C6B12830A3C32EF90E53A60373B00FCCAFFAFCEEEEAFBEFEFEEBBAA33334A31D"body":[{scenicno",teegintimenumerokednumberer{scenicno",teegintimeendtimenumerokednumberer}]}{"head":{tIdtimestamp",nsignFFEFC5634D1977CF523198528188F36FD654922BB739DAEF7FAEADBF59F60BEE190F283B188D3AB2E4B4B35C2C36E2F5D6msgsuccess"}}文化场馆和旅游景区开放状态数据交互接口请求参数表A.11规定了文化场馆和旅游景区状态数据交互接口请求参数。文化场馆和旅游景区状态数据交互接口请求参数scenic_noString编码report_dateStringyyyyMMddbegin_timeStringyyyyMMddHHmmssend_timeStringyyyyMMddHHmmssstatusString0:1:2:3:4:开放日(待补充)响应参数表A.12规定了文化场馆和旅游景区状态数据交互接口响应参数。文化场馆和旅游景区状态数据交互接口响应参数codeString01msgString处理结果描述处理成功报文示例下面给出了报