検索
  • サインイン
  • サインアップ
パスワードのリセットが成功しました

興味のあるプロジェクトをフォローし、それらに関する最新ニュースをチェックしてください

スペシャルチケット

コレクション 105
リーディング 40449
更新時間 2016-09-11

特殊票类

会议/演出门票

支持开发者调用接口创建会议/演出门票,并当用户领取门票,调用更新门票接口将座位、入口等信息更新至门票。

1476411403493792.jpg

创建会议门票

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

参数说明

参数是否必须说明
access_token调用接口凭证
POST数据Json数据

POST数据示例:

{ 
"card": {
   "card_type": "MEETING_TICKET",
   "meeting_ticket": {
       "base_info": {
           "logo_url": 
"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0",
           "brand_name":"票务公司",
           "code_type":"CODE_TYPE_TEXT",
           "title": "XX会议",
           "color": "Color010",
           "notice": "使用时向检票员出示此券",
           "service_phone": "020-88888888",
           "description": "请务必准时入场",
           "date_info": {
               "type": 1,
               "begin_timestamp": 1397577600 ,
               "end_timestamp": 1422724261
           },
           "sku": {
               "quantity": 50000000
           },
           "get_limit": 3,
           "use_custom_code": false,
           "bind_openid": false,
           "can_share": true,
           "can_give_friend": true,
           "location_id_list" : [123, 12321, 345345],
           "custom_url_name": "查看更多",
           "custom_url": "http://www.qq.com",
           "custom_url_sub_title": "6个汉字tips",
                  },
       "meeting_detail": "会议时间:xxx;地点:xxx "}
 }
}
参数名必填类型示例值描述
card_typestring(24)MEETING_TICKET会议门票类型。
base_infoJson结构见上述示例。基本的卡券数据,见下表,所有卡券通用。
meeting_detailstring(3072)本次会议于2015年5月10号在广州举行,会场地点:xxxx。会议详情。
map_urlstring(128)xxx.com会场导览图。

base_info字段

参数名必填类型示例值描述
logo_urlstring(128)http://mmbiz.qpic.cn/卡券的商户logo,建议像素为300*300。
code_typestring(16)CODE_TYPE_TEXTCode展示类型,"CODE_TYPE_TEXT",文本;"CODE_TYPE_BARCODE",一维码 ;"CODE_TYPE_QRCODE",二维码;"CODE_TYPE_ONLY_QRCODE",二维码无code显示;"CODE_TYPE_ONLY_BARCODE",一维码无code显示;
brand_namestring(36)xx票务公司商户名字,字数上限为12个汉字。
titlestring(27)xx会议门票卡券名,字数上限为9个汉字。(建议涵盖卡券属性、服务及金额)。
colorstring(16)Color010券颜色。按色彩规范标注填写Color010-Color100。
noticestring(48)请出示二维码核销卡券卡券使用提醒,字数上限为16个汉字。
descriptionstring(3072)不可与其他优惠同享/n如需团购券发票,请向店员提出要求。卡券使用说明,字数上限为1024个汉字。
skuJson结构见上述示例。商品信息。
quantityint100000卡券库存的数量,不支持填写0,上限为100000000。
date_infoJson结构见上述示例。使用日期,有效期的信息。
typeint1使用时间的类型,仅支持填写1或2。1为固定日期区间,2为固定时长(自领取后按天算)。
begin_timestampunsigned int14300000type为1时专用,表示起用时间。从1970年1月1日00:00:00至起用时间的秒数,最终需转换为字符串形态传入。(东八区时间,单位为秒)
end_timestampunsigned int15300000type为1时专用,表示结束时间,建议设置为截止日期的23:59:59过期。(东八区时间,单位为秒)
fixed_termint0type为2时专用,表示自领取后多少天内有效,领取后当天有效填写0。(单位为天)
fixed_begin_termint15type为2时专用,表示自领取后多少天开始生效。(单位为天)
use_custom_codebooltrue是否自定义Code码。填写true或false,默认为false。通常自有优惠码系统的开发者选择自定义Code码,在卡券投放时带入。
bind_openidbooltrue是否指定用户领取,填写true或false。默认为false。
service_phonestring(24)40012234客服电话。
location_id_listarray1234,2312门店位置ID。调用POI门店管理接口获取门店位置ID。
sourcestring(36)大众点评第三方来源名,例如同程旅游、大众点评。
custom_url_namestring(15)立即使用自定义跳转外链的入口名字。
custom_urlstring(128)"xxxx.com"自定义跳转的URL。
custom_url_sub_titlestring(18)更多惊喜显示在入口右侧的提示语。
promotion_url_namestring(15)产品介绍营销场景的自定义入口名称。
promotion_urlstring(128)XXXX.com入口跳转外链的地址链接。
promotion_url_sub_titlestring(18)卖场大优惠。显示在营销入口右侧的提示语。
get_limitint1每人可领券的数量限制。
can_shareboolfalse卡券领取页面是否可分享。
can_give_friendboolfalse卡券是否可转赠。

返回说明

数据示例:

{
   "errcode":0,
   "errmsg":"ok",
   "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
参数名描述
errcode错误码,0为正常。
errmsg错误信息。
card_id卡券ID。

更新会议门票

支持调用“更新会议门票”接口update 入场时间、区域、座位等信息。

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/card/meetingticket/updateuser?access_token=TOKEN

参数说明

参数是否必须说明
access_token调用接口凭证
POST数据Json数据
{
   "code": "717523732898",
   "card_id": "pXch-jvdwkJjY7evUFV-sGsoMl7A",
   "zone" : "C区",
   "entrance" : "东北门",
   "seat_number" : "2排15号"
}
参数名必填类型示例值描述
codestring(20)1231123卡券Code码。
card_idstring(32)pXch-jvdwkJjY7evUFV-sGsoMl7A要更新门票序列号所述的card_id,生成券时use_custom_code 填写true 时必填。
begin_timeunsigned int1433432201开场时间,Unix时间戳格式。
end_timeunsigned int1433432401结束时间,Unix时间戳格式。
zonestring(12)C 区区域。
entrancestring(12)3号门入口。
seat_numberstring(12)2 排15 号座位号。

返回说明

数据示例:

{
   "errcode":0,
   "errmsg":"ok"
}
参数名描述
errcode错误码,0为正常。
errmsg错误信息。

景区门票

创建景区门票

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

参数说明

参数是否必须说明
access_token调用接口凭证
POST数据Json数据
{ 
"card": {
   "card_type": "SCENIC_TICKET",
   "scenic_ticket": {
       "base_info": {
          },
       "ticket_class": "全日票"
   }
  }
 }
参数名必填类型示例值描述
card_typestring(24)SCENIC_TICKET景区门票类型。
base_infoJson结构见上述示例。基本的卡券数据,见下表,所有卡券通用。
ticket_classstring(3072)平日全票票类型,例如平日全票,套票等。
guide_urlstring(128)xxx.com导览图url


参数名必填类型示例值描述
logo_urlstring(128)http://mmbiz.qpic.cn/卡券的商户logo,建议像素为300*300。
code_typestring(16)CODE_TYPE_TEXTCode展示类型,"CODE_TYPE_TEXT",文本;"CODE_TYPE_BARCODE",一维码 ;"CODE_TYPE_QRCODE",二维码;"CODE_TYPE_ONLY_QRCODE",二维码无code显示;"CODE_TYPE_ONLY_BARCODE",一维码无code显示;
brand_namestring(36)长隆旅游景区商户名字,字数上限为12个汉字。
titlestring(27)景区通票卡券名,字数上限为9个汉字。(建议涵盖卡券属性、服务及金额)。
colorstring(16)Color010券颜色。按色彩规范标注填写Color010-Color100。详情见获取颜色列表接口
noticestring(48)请出示二维码核销卡券卡券使用提醒,字数上限为16个汉字。
descriptionstring(3072)不可与其他优惠同享/n如需团购券发票,请向店员提出要求。卡券使用说明,字数上限为1024个汉字。
skuJson结构见上述示例。商品信息。
quantityint100000卡券库存的数量,不支持填写0,上限为100000000。
date_infoJson结构见上述示例。使用日期,有效期的信息。
typeint1使用时间的类型,仅支持填写1或2。1为固定日期区间,2为固定时长(自领取后按天算)。
begin_timestampunsigned int14300000type为1时专用,表示起用时间。从1970年1月1日00:00:00至起用时间的秒数,最终需转换为字符串形态传入。(东八区时间,单位为秒)
end_timestampunsigned int15300000type为1时专用,表示结束时间,建议设置为截止日期的23:59:59过期。(东八区时间,单位为秒)
fixed_termint0type为2时专用,表示自领取后多少天内有效,领取后当天有效填写0。(单位为天)
fixed_begin_termint15type为2时专用,表示自领取后多少天开始生效。(单位为天)
use_custom_codebooltrue是否自定义Code码。填写true或false,默认为false。通常自有优惠码系统的开发者选择自定义Code码,在卡券投放时带入。
bind_openidbooltrue是否指定用户领取,填写true或false。默认为false。
service_phonestring(24)40012234客服电话。
location_id_listarray1234,2312门店位置ID。调用POI门店管理接口获取门店位置ID。
sourcestring(36)大众点评第三方来源名,例如同程旅游、大众点评。
custom_url_namestring(15)立即使用自定义跳转外链的入口名字。
custom_urlstring(128)"xxxx.com"自定义跳转的URL。
custom_url_sub_titlestring(18)更多惊喜显示在入口右侧的提示语。
promotion_url_namestring(15)产品介绍营销场景的自定义入口名称。
promotion_urlstring(128)XXXX.com入口跳转外链的地址链接。
promotion_url_sub_titlestring(18)卖场大优惠。显示在营销入口右侧的提示语。
get_limitint1每人可领券的数量限制。
can_shareboolfalse卡券领取页面是否可分享。
can_give_friendboolfalse卡券是否可转赠。

返回说明

数据示例:

{
   "errcode":0,
   "errmsg":"ok",
   "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
参数名描述
errcode错误码,0为正常。
errmsg错误信息。
card_id卡券ID。

电影票

电影票券主要分为以下两种:

1、电影票兑换券,归属于团购券。

2、选座电影票,在购买时需要选定电影、场次、座位,具备较强的时效性和特殊性,此类电影票券即文档中的电影票。

使用场景: 用户点击商户H5页面提供的添加至卡包JS-SDK后,商户根据用户电影票信息,调用接口创建卡券,获取card_id后,将带有唯一Code码的电影票下发给用户,用户领取后通过接口(更新电影票)update用户选座信息。

1476411431839995.jpg

创建电影票

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

参数说明

参数是否必须说明
access_token调用接口凭证
POST数据Json数据
{ 
"card": {
   "card_type": "MOVIE_TICKET",
   "movie_ticket": {
       "base_info": {
          },
       "detail": "电影名:xxx,电影简介:xxx"
   }
  }
 }
参数名必填类型示例值描述
card_typestring(24)MOVIE_TICKET电影票类型。
base_infoJson结构见上述示例。基本的卡券数据,见下表,所有卡券通用。
detailstring(3072)电影名:xxx,电影简介:xxx。电影票详情

base_info字段

参数名必填类型示例值描述
logo_urlstring(128)http://mmbiz.qpic.cn/卡券的商户logo,建议像素为300*300。
code_typestring(16)CODE_TYPE_TEXTCode展示类型,"CODE_TYPE_TEXT",文本;"CODE_TYPE_BARCODE",一维码 ;"CODE_TYPE_QRCODE",二维码;"CODE_TYPE_ONLY_QRCODE",二维码无code显示;"CODE_TYPE_ONLY_BARCODE",一维码无code显示;
brand_namestring(36)电影票商户名字,字数上限为12个汉字。
titlestring(27)复仇者联盟2卡券名,字数上限为9个汉字。(建议涵盖卡券属性、服务及金额)。
colorstring(16)Color010券颜色。按色彩规范标注填写Color010-Color100。详情见获取颜色列表接口
noticestring(48)输入兑换码核销卡券使用提醒,字数上限为16个汉字。
descriptionstring(3072)不可与其他优惠同享。卡券使用说明,字数上限为1024个汉字。
skuJson结构见上述示例。商品信息。
quantityint100000卡券库存的数量,不支持填写0,上限为100000000。
date_infoJson结构见上述示例。使用日期,有效期的信息。
typeint1使用时间的类型,仅支持填写1或2。1为固定日期区间,2为固定时长(自领取后按天算)。
begin_timestampunsigned int14300000type为1时专用,表示起用时间。从1970年1月1日00:00:00至起用时间的秒数,最终需转换为字符串形态传入。(东八区时间,单位为秒)
end_timestampunsigned int15300000type为1时专用,表示结束时间,建议设置为截止日期的23:59:59过期。(东八区时间,单位为秒)
fixed_termint0type为2时专用,表示自领取后多少天内有效,领取后当天有效填写0。(单位为天)
fixed_begin_termint15type为2时专用,表示自领取后多少天开始生效。(单位为天)
use_custom_codebooltrue是否自定义Code码。填写true或false,默认为false。通常自有优惠码系统的开发者选择自定义Code码,在卡券投放时带入。
bind_openidbooltrue是否指定用户领取,填写true或false。默认为false。
service_phonestring(24)40012234客服电话。
location_id_listarray1234,2312门店位置ID。调用POI门店管理接口获取门店位置ID。
sourcestring(36)大众点评第三方来源名,例如同程旅游、大众点评。
custom_url_namestring(15)立即使用自定义跳转外链的入口名字。
custom_urlstring(128)"xxxx.com"自定义跳转的URL。
custom_url_sub_titlestring(18)更多惊喜显示在入口右侧的提示语。
promotion_url_namestring(15)产品介绍营销场景的自定义入口名称。
promotion_urlstring(128)XXXX.com入口跳转外链的地址链接。
promotion_url_sub_titlestring(18)卖场大优惠。显示在营销入口右侧的提示语。
get_limitint1每人可领券的数量限制。
can_shareboolfalse卡券领取页面是否可分享。
can_give_friendboolfalse卡券是否可转赠。

更新电影票

领取电影票后通过调用“更新电影票”接口update电影信息及用户选座信息。

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/card/movieticket/updateuser?access_token=TOKEN

参数说明

参数是否必须说明
access_token调用接口凭证
POST数据Json数据
 {   
"code" : "277217129962",
"card_id": "p1Pj9jr90_SQRaVqYI239Ka1erkI",
"ticket_class": "4D",
"show_time": 1408493192,
"duration":120,
"screening_room": "5号影厅",
"seat_number": [ "5 排14 号" , "5排15号" ]
  }
参数名必填类型示例值描述
codestring(20)1231123卡券Code码。
card_idstring(32)持白金会员卡到店消费,可享8折优惠。要更新门票序列号所述的card_id,生成券时use_custom_code填写true时必填。
ticket_classstring(12)2D电影票的类别,如2D、3D。
screening_roomstring(12)A厅该场电影的影厅信息。
seat_numberstring(12)5排10座座位号。
show_timeunsigned int14300000电影的放映时间,Unix时间戳格式。
durationint120放映时长,填写整数。

返回说明

数据示例:

{
   "errcode":0,
   "errmsg":"ok"
}
参数名描述
errcode错误码,0为正常。
errmsg错误信息。

飞机票


飞机票与其他卡券相比具有更强的时效性和特殊性,故机票生成后无需经过微信审核,即时生效。 机票使用场景主要分为以下两种:

1、通过微信购买后直接添加至卡包,可值机时段由卡包在线办理登机牌。

2、在微信商户(一般为航空公司)公众号内完成值机后,添加至微信卡包。

第一种场景: 用户点击商户H5页面“添加至卡包”后,商户根据用户机票信息,调用接口创建卡券,获取card_id后,将机票下发给用户。在可值机时段,用户点击商户指定的URL在线办理登机牌。办理成功后,商户调用更新机票信息接口,将值机信息同步。

第二种场景: 用户点击商户H5页面提供的JS API后,商户根据用户机票信息,调用接口生成卡券,获取card_id后,将机票下发给用户。并立即更新机票接口,将值机信息同步。

创建飞机票接口



1476411472573618.jpg

接口调用请求说明

HTTPS请求方式: POST
URL:https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

参数说明

参数是否必须说明
access_token调用接口凭证
POST数据Json数据
{
"card": {
   "card_type": "BOARDING_PASS",
   "boarding_pass": {
       "base_info": {
        xxxxxxxxxxxxxxxxxxxx
        xxxxxxxxxxxxxxxxxxxxx
       },
       "from": "成都",
       "to": "广州",
       "flight": "CE123",
       "departure_time": "1434507901",
       "landing_time": "1434909901",
       "air_model": "空客A320"
   }
  }
 }

机票专属字段:

参数名必填类型示例值描述
card_typestring(24)BOARDING_PASS飞机票类型。
base_infoJSON结构见示例基本的卡券数据,所有卡券通用,详细字段见下表。
fromstring(54)成都起点,上限为18个汉字。
tostring(54)广州终点,上限为18个汉字。
flightstring(24)CE123航班
gatestring(12)A11入口,上限为4个汉字。
check_in_urlstring(128)xxx.com在线值机的链接。
air_modelstring(24)空客A320机型,上限为8个汉字。
departure_timestring(128)1434507901起飞时间。Unix时间戳格式。
landing_timestring(128)1434909901降落时间。Unix时间戳格式。


返回说明

数据示例:

{
   "errcode":0,
   "errmsg":"ok",
   "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
参数名描述
errcode错误码,0为正常。
errmsg错误信息。
card_id卡券ID。

更新飞机票信息接口

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/card/boardingpass/checkin?access_token=TOKEN

参数说明

参数是否必须说明
access_token调用接口凭证
POST数据Json数据
{
"code": "198374613512",
"card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI",
"passenger_name": "乘客姓名",
"class": "舱等",
"seat": "座位号",
"etkt_bnr": "电子客票号",
"qrcode_data": "二维码数据",
"is_cancel ": false
}
参数名必填类型示例值描述
codestring(20)1231123卡券Code码。
card_idstring(32)p1Pj9jr90_SQRaVqYI239Ka1erkI卡券ID,自定义Code码的卡券必填。
etkt_bnrstring(14)1234567电子客票号,上限为14个数字。
classstring(15)经济舱。舱等,如头等舱等,上限为5个汉字。
qrcode_datastring(3072)12345二维码数据。乘客用于值机的二维码字符串,微信会通过此数据为用户生成值机用的二维码。
seatstring(12)5排c号乘客座位号。
is_cancelboolfalse是否取消值机。填写true或false。true代表取消,如填写true上述字段(如calss等)均不做判断,机票返回未值机状态,乘客可重新值机。默认填写false。

返回说明

数据示例:

{
   "errcode":0,
   "errmsg":"ok"
}
参数名描述
errcode错误码,0为正常。
errmsg错误信息。

ホットAIツール
Undress AI Tool
Undress AI Tool

脱衣画像を無料で

AI Clothes Remover
AI Clothes Remover

写真から衣服を削除するオンライン AI ツール。

Undresser.AI Undress
Undresser.AI Undress

リアルなヌード写真を作成する AI 搭載アプリ

Stock Market GPT
Stock Market GPT

AIを活用した投資調査により賢明な意思決定を実現

人気のツール
メモ帳++7.3.1
メモ帳++7.3.1

使いやすく無料のコードエディター

SublimeText3 中国語版
SublimeText3 中国語版

中国語版、とても使いやすい

ゼンドスタジオ 13.0.1
ゼンドスタジオ 13.0.1

強力な PHP 統合開発環境

ドリームウィーバー CS6
ドリームウィーバー CS6

ビジュアル Web 開発ツール

SublimeText3 Mac版
SublimeText3 Mac版

神レベルのコード編集ソフト(SublimeText3)