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

《文化场馆和旅游景区身份核验系统一卡通接口说明.docx》由会员分享，可在线阅读，更多相关《文化场馆和旅游景区身份核验系统一卡通接口说明.docx（13页珍藏版）》请在优知文库上搜索。

1、文化场馆和旅游景区身份核验系统一卡通接口说明报文结构说明请求参数说明请求参数说明包含以下内容：a）报文以JSON格式定义；报文分为head部分和body部分；head部分为公共部分，见表A.1；body部分参考具体接口说明。报文请求参数head部分参数类型是否必填最大长度描述示例值appletString是8为设备所属商户（系统商）分配的应用ID,8位字母及数字组合字符串requestIdString是16请求编号，数字形式timestampString是18时间戳，YyyyMMddHHmmssSSS一versionString是8版本1.0signString是200使用SM3加密，内容为a

2、ppld、timestamp、ClientSecret拼接的字符串，符合GB/T32905-2016信息安全技术SM3密码杂凑算法要求。CIientSeCret为设备所属商户（系统商）分配的加密KEYo服务端会校验sign是否正确。响应参数说明响应参数说明包含以下内容：a）报文以JSoN格式定义；包体分为head部分和body部分;head部分为公共部分,见表A.2；body部分参考具体接口说明。报文响应参数head部分参数类型是否必填最大长度描述示例值appldString是8为设备所属商户（系统商）分配的应用ID,8位字母及数字组合字符串一requestldString是16请求编号，数字

3、一timestampString是18时间戳，YyyyMMddHHmmssSSS一versionString是8版本例：LOsignString是200使用SM3加密，内容为appld、timestampclientSecret拼接的字符串，符合GB/T32905-2016信息安全技术SM3密码杂凑算法要求。ClientSecret为设备所属商户（系统商）分配的加密KEY身份校验数据交互接口请求参数表A.3规定了个人身份核验数据交互接口请求参数。个人身份核验数据交互接口请求参数参数类型是否必填最大长度描述示例值qrcode_infoString是500社保卡使用卡识别码，身份证使用身份证号码，

4、市民卡使用卡号，电子社保卡使用二维码原始字符串，苏服码使用二维码原始字符串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姓名（当介质类型

5、为身份证时必填）card_numberString否99位社保卡号（当介质类型为社保卡时必网）card_versionString否8K规范版本（当介质类型为社保卡时必填）例：3.00publish_dateString否18发卡日期（当介质类型为社保卡时必填）格式：yyyyMMddexpirydateString否8卡有效期（当介质类型为社保卡时必填）格式：yyyyMMcard_rest_infoString否64卡复位信息（当介质类型为社保卡时必填）响应参数表A.4规定了个人身份核验数据交互接口响应参数。个人身份核验数据交互接口响应参数参数类型是否必填最大长度描述示例值codeString

6、是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”,tvers

7、ion:1.0,*sign*:*F14030A0C789CCE650D5971260C6B12830A3C32EF90E53A60373BOOFCC1AF68F86A56850975F2CE71IEEEl1600A4629485FB13EFE55F5EEBB0A565A33334A31D”,body:*qrcode_info*,3200000101845190273800，card_type:03,seenic_no:320117-0-L-02-0001”,“device_codeNJ1002210,biz_type:1,z,contactname:王晓梅，“contact_PhOne:139

8、XXXXXXxx”,user_name:张二,“cardnumber:123456789”,“careLVerSiOn:3.00”,publish_date”:20210504,“expiry_date:202505”,cardrestinfo:)(“head:“appld:182051110，“requestId:123”,timestamp:20201124160354”,.reversion:1.0,sign:739F1F87E7F767C15634D1977CF523198528188F36FD654922BB739DEE7F78844E061AD463B1E05259F60BEE19

9、0F283B188D3B2E4B4B35C2C36E2F5D615D9”),body:code:0,msg:success,si_no:320111197010153465”,name:张二，“si_card_join_area:320001,“occupationCOde:020203”,s-vald:0)团体身份校验数据交互接口请求参数表A.5规定了团体身份核验数据交互接口请求参数。团体身份核验数据交互接口请求参数参数类型是否必填最大长度描述示例值qrcodeinfoString是500社保卡使用卡识别码，身份证使用身份证号码，市民卡使用卡号，电子社保卡使用二维码原始字符串，苏服码使用二维

10、码原始字符串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_nameStrin

11、g否32姓名（当介质类型为身份证时必填）card_numberString否99位社保卡号（当介质类型为社保卡时必填）card_versionString否8卡规范版本（当介质类型为社保卡时必填）例：3.00publish_dateString否18发卡日期（当介质类型为社保卡时必填）格式：VyyyMMddexpirydateString否8卡有效期（当介质类型为社保卡时必填）格式：yyyyMMcardrestinfoString否64卡复位信息（当介质类型为社保卡时必填）响应参数表A.6规定了团体身份核验数据交互接口响应参数。团体身份核验数据交互接口响应参数参数类型是否必填最大长度描述示例值

12、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:2021112415205

13、4354”,八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_car