支持開發(fā)者調(diào)用接口創(chuàng)建會(huì)議/演出門票,并當(dāng)用戶領(lǐng)取門票,調(diào)用更新門票接口將座位、入口等信息更新至門票。
接口調(diào)用請(qǐng)求說明
http請(qǐng)求方式: POSThttps://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
POST數(shù)據(jù) | 是 | Json數(shù)據(jù) |
POST數(shù)據(jù)示例:
{
"card": {
"card_type": "MEETING_TICKET",
"meeting_ticket": {
"base_info": {
"logo_url":
"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0",
"brand_name":"票務(wù)公司",
"code_type":"CODE_TYPE_TEXT",
"title": "XX會(huì)議",
"color": "Color010",
"notice": "使用時(shí)向檢票員出示此券",
"service_phone": "020-88888888",
"description": "請(qǐng)務(wù)必準(zhǔn)時(shí)入場(chǎng)",
"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個(gè)漢字tips",
},
"meeting_detail": "會(huì)議時(shí)間:xxx;地點(diǎn):xxx "}
}
}
參數(shù)名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|
card_type | 是 | string(24) | MEETING_TICKET | 會(huì)議門票類型。 |
base_info | 是 | Json結(jié)構(gòu) | 見上述示例。 | 基本的卡券數(shù)據(jù),見下表,所有卡券通用。 |
meeting_detail | 是 | string(3072) | 本次會(huì)議于2015年5月10號(hào)在廣州舉行,會(huì)場(chǎng)地點(diǎn):xxxx。 | 會(huì)議詳情。 |
map_url | 否 | string(128) | xxx.com | 會(huì)場(chǎng)導(dǎo)覽圖。 |
base_info字段
參數(shù)名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|
logo_url | 是 | string(128) | http://mmbiz.qpic.cn/ | 卡券的商戶logo,建議像素為300*300。 |
code_type | 是 | string(16) | CODE_TYPE_TEXT | Code展示類型,"CODE_TYPE_TEXT",文本;"CODE_TYPE_BARCODE",一維碼 ;"CODE_TYPE_QRCODE",二維碼;"CODE_TYPE_ONLY_QRCODE",二維碼無code顯示;"CODE_TYPE_ONLY_BARCODE",一維碼無code顯示; |
brand_name | 是 | string(36) | xx票務(wù)公司 | 商戶名字,字?jǐn)?shù)上限為12個(gè)漢字。 |
title | 是 | string(27) | xx會(huì)議門票 | 卡券名,字?jǐn)?shù)上限為9個(gè)漢字。(建議涵蓋卡券屬性、服務(wù)及金額)。 |
color | 是 | string(16) | Color010 | 券顏色。按色彩規(guī)范標(biāo)注填寫Color010-Color100。 |
notice | 是 | string(48) | 請(qǐng)出示二維碼核銷卡券 | 卡券使用提醒,字?jǐn)?shù)上限為16個(gè)漢字。 |
description | 是 | string(3072) | 不可與其他優(yōu)惠同享/n如需團(tuán)購券發(fā)票,請(qǐng)向店員提出要求。 | 卡券使用說明,字?jǐn)?shù)上限為1024個(gè)漢字。 |
sku | 是 | Json結(jié)構(gòu) | 見上述示例。 | 商品信息。 |
quantity | 是 | int | 100000 | 卡券庫存的數(shù)量,不支持填寫0,上限為100000000。 |
date_info | 是 | Json結(jié)構(gòu) | 見上述示例。 | 使用日期,有效期的信息。 |
type | 是 | int | 1 | 使用時(shí)間的類型,僅支持填寫1或2。1為固定日期區(qū)間,2為固定時(shí)長(自領(lǐng)取后按天算)。 |
begin_timestamp | 否 | unsigned int | 14300000 | type為1時(shí)專用,表示起用時(shí)間。從1970年1月1日00:00:00至起用時(shí)間的秒數(shù),最終需轉(zhuǎn)換為字符串形態(tài)傳入。(東八區(qū)時(shí)間,單位為秒) |
end_timestamp | 否 | unsigned int | 15300000 | type為1時(shí)專用,表示結(jié)束時(shí)間,建議設(shè)置為截止日期的23:59:59過期。(東八區(qū)時(shí)間,單位為秒) |
fixed_term | 否 | int | 0 | type為2時(shí)專用,表示自領(lǐng)取后多少天內(nèi)有效,領(lǐng)取后當(dāng)天有效填寫0。(單位為天) |
fixed_begin_term | 否 | int | 15 | type為2時(shí)專用,表示自領(lǐng)取后多少天開始生效。(單位為天) |
use_custom_code | 否 | bool | true | 是否自定義Code碼。填寫true或false,默認(rèn)為false。通常自有優(yōu)惠碼系統(tǒng)的開發(fā)者選擇自定義Code碼,在卡券投放時(shí)帶入。 |
bind_openid | 否 | bool | true | 是否指定用戶領(lǐng)取,填寫true或false。默認(rèn)為false。 |
service_phone | 否 | string(24) | 40012234 | 客服電話。 |
location_id_list | 否 | array | 1234,2312 | 門店位置ID。調(diào)用POI門店管理接口獲取門店位置ID。 |
source | 否 | string(36) | 大眾點(diǎn)評(píng) | 第三方來源名,例如同程旅游、大眾點(diǎn)評(píng)。 |
custom_url_name | 否 | string(15) | 立即使用 | 自定義跳轉(zhuǎn)外鏈的入口名字。 |
custom_url | 否 | string(128) | "xxxx.com" | 自定義跳轉(zhuǎn)的URL。 |
custom_url_sub_title | 否 | string(18) | 更多驚喜 | 顯示在入口右側(cè)的提示語。 |
promotion_url_name | 否 | string(15) | 產(chǎn)品介紹 | 營銷場(chǎng)景的自定義入口名稱。 |
promotion_url | 否 | string(128) | XXXX.com | 入口跳轉(zhuǎn)外鏈的地址鏈接。 |
promotion_url_sub_title | 否 | string(18) | 賣場(chǎng)大優(yōu)惠。 | 顯示在營銷入口右側(cè)的提示語。 |
get_limit | 否 | int | 1 | 每人可領(lǐng)券的數(shù)量限制。 |
can_share | 否 | bool | false | 卡券領(lǐng)取頁面是否可分享。 |
can_give_friend | 否 | bool | false | 卡券是否可轉(zhuǎn)贈(zèng)。 |
返回說明
數(shù)據(jù)示例:
{
"errcode":0,
"errmsg":"ok",
"card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
參數(shù)名 | 描述 |
---|---|
errcode | 錯(cuò)誤碼,0為正常。 |
errmsg | 錯(cuò)誤信息。 |
card_id | 卡券ID。 |
支持調(diào)用“更新會(huì)議門票”接口update 入場(chǎng)時(shí)間、區(qū)域、座位等信息。
接口調(diào)用請(qǐng)求說明
http請(qǐng)求方式: POSThttps://api.weixin.qq.com/card/meetingticket/updateuser?access_token=TOKEN
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
POST數(shù)據(jù) | 是 | Json數(shù)據(jù) |
{
"code": "717523732898",
"card_id": "pXch-jvdwkJjY7evUFV-sGsoMl7A",
"zone" : "C區(qū)",
"entrance" : "東北門",
"seat_number" : "2排15號(hào)"
}
參數(shù)名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|
code | 是 | string(20) | 1231123 | 卡券Code碼。 |
card_id | 否 | string(32) | pXch-jvdwkJjY7evUFV-sGsoMl7A | 要更新門票序列號(hào)所述的card_id,生成券時(shí)use_custom_code 填寫true 時(shí)必填。 |
begin_time | 否 | unsigned int | 1433432201 | 開場(chǎng)時(shí)間,Unix時(shí)間戳格式。 |
end_time | 否 | unsigned int | 1433432401 | 結(jié)束時(shí)間,Unix時(shí)間戳格式。 |
zone | 是 | string(12) | C 區(qū) | 區(qū)域。 |
entrance | 是 | string(12) | 3號(hào)門 | 入口。 |
seat_number | 是 | string(12) | 2 排15 號(hào) | 座位號(hào)。 |
返回說明
數(shù)據(jù)示例:
{
"errcode":0,
"errmsg":"ok"
}
參數(shù)名 | 描述 |
---|---|
errcode | 錯(cuò)誤碼,0為正常。 |
errmsg | 錯(cuò)誤信息。 |
接口調(diào)用請(qǐng)求說明
http請(qǐng)求方式: POSThttps://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
POST數(shù)據(jù) | 是 | Json數(shù)據(jù) |
{
"card": {
"card_type": "SCENIC_TICKET",
"scenic_ticket": {
"base_info": {
},
"ticket_class": "全日票"
}
}
}
參數(shù)名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|
card_type | 是 | string(24) | SCENIC_TICKET | 景區(qū)門票類型。 |
base_info | 是 | Json結(jié)構(gòu) | 見上述示例。 | 基本的卡券數(shù)據(jù),見下表,所有卡券通用。 |
ticket_class | 是 | string(3072) | 平日全票 | 票類型,例如平日全票,套票等。 |
guide_url | 否 | string(128) | xxx.com | 導(dǎo)覽圖url |
參數(shù)名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|
logo_url | 是 | string(128) | http://mmbiz.qpic.cn/ | 卡券的商戶logo,建議像素為300*300。 |
code_type | 是 | string(16) | CODE_TYPE_TEXT | Code展示類型,"CODE_TYPE_TEXT",文本;"CODE_TYPE_BARCODE",一維碼 ;"CODE_TYPE_QRCODE",二維碼;"CODE_TYPE_ONLY_QRCODE",二維碼無code顯示;"CODE_TYPE_ONLY_BARCODE",一維碼無code顯示; |
brand_name | 是 | string(36) | 長隆旅游景區(qū) | 商戶名字,字?jǐn)?shù)上限為12個(gè)漢字。 |
title | 是 | string(27) | 景區(qū)通票 | 卡券名,字?jǐn)?shù)上限為9個(gè)漢字。(建議涵蓋卡券屬性、服務(wù)及金額)。 |
color | 是 | string(16) | Color010 | 券顏色。按色彩規(guī)范標(biāo)注填寫Color010-Color100。詳情見獲取顏色列表接口 |
notice | 是 | string(48) | 請(qǐng)出示二維碼核銷卡券 | 卡券使用提醒,字?jǐn)?shù)上限為16個(gè)漢字。 |
description | 是 | string(3072) | 不可與其他優(yōu)惠同享/n如需團(tuán)購券發(fā)票,請(qǐng)向店員提出要求。 | 卡券使用說明,字?jǐn)?shù)上限為1024個(gè)漢字。 |
sku | 是 | Json結(jié)構(gòu) | 見上述示例。 | 商品信息。 |
quantity | 是 | int | 100000 | 卡券庫存的數(shù)量,不支持填寫0,上限為100000000。 |
date_info | 是 | Json結(jié)構(gòu) | 見上述示例。 | 使用日期,有效期的信息。 |
type | 是 | int | 1 | 使用時(shí)間的類型,僅支持填寫1或2。1為固定日期區(qū)間,2為固定時(shí)長(自領(lǐng)取后按天算)。 |
begin_timestamp | 否 | unsigned int | 14300000 | type為1時(shí)專用,表示起用時(shí)間。從1970年1月1日00:00:00至起用時(shí)間的秒數(shù),最終需轉(zhuǎn)換為字符串形態(tài)傳入。(東八區(qū)時(shí)間,單位為秒) |
end_timestamp | 否 | unsigned int | 15300000 | type為1時(shí)專用,表示結(jié)束時(shí)間,建議設(shè)置為截止日期的23:59:59過期。(東八區(qū)時(shí)間,單位為秒) |
fixed_term | 否 | int | 0 | type為2時(shí)專用,表示自領(lǐng)取后多少天內(nèi)有效,領(lǐng)取后當(dāng)天有效填寫0。(單位為天) |
fixed_begin_term | 否 | int | 15 | type為2時(shí)專用,表示自領(lǐng)取后多少天開始生效。(單位為天) |
use_custom_code | 否 | bool | true | 是否自定義Code碼。填寫true或false,默認(rèn)為false。通常自有優(yōu)惠碼系統(tǒng)的開發(fā)者選擇自定義Code碼,在卡券投放時(shí)帶入。 |
bind_openid | 否 | bool | true | 是否指定用戶領(lǐng)取,填寫true或false。默認(rèn)為false。 |
service_phone | 否 | string(24) | 40012234 | 客服電話。 |
location_id_list | 否 | array | 1234,2312 | 門店位置ID。調(diào)用POI門店管理接口獲取門店位置ID。 |
source | 否 | string(36) | 大眾點(diǎn)評(píng) | 第三方來源名,例如同程旅游、大眾點(diǎn)評(píng)。 |
custom_url_name | 否 | string(15) | 立即使用 | 自定義跳轉(zhuǎn)外鏈的入口名字。 |
custom_url | 否 | string(128) | "xxxx.com" | 自定義跳轉(zhuǎn)的URL。 |
custom_url_sub_title | 否 | string(18) | 更多驚喜 | 顯示在入口右側(cè)的提示語。 |
promotion_url_name | 否 | string(15) | 產(chǎn)品介紹 | 營銷場(chǎng)景的自定義入口名稱。 |
promotion_url | 否 | string(128) | XXXX.com | 入口跳轉(zhuǎn)外鏈的地址鏈接。 |
promotion_url_sub_title | 否 | string(18) | 賣場(chǎng)大優(yōu)惠。 | 顯示在營銷入口右側(cè)的提示語。 |
get_limit | 否 | int | 1 | 每人可領(lǐng)券的數(shù)量限制。 |
can_share | 否 | bool | false | 卡券領(lǐng)取頁面是否可分享。 |
can_give_friend | 否 | bool | false | 卡券是否可轉(zhuǎn)贈(zèng)。 |
返回說明
數(shù)據(jù)示例:
{
"errcode":0,
"errmsg":"ok",
"card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
參數(shù)名 | 描述 |
---|---|
errcode | 錯(cuò)誤碼,0為正常。 |
errmsg | 錯(cuò)誤信息。 |
card_id | 卡券ID。 |
電影票券主要分為以下兩種:
1、電影票兌換券,歸屬于團(tuán)購券。
2、選座電影票,在購買時(shí)需要選定電影、場(chǎng)次、座位,具備較強(qiáng)的時(shí)效性和特殊性,此類電影票券即文檔中的電影票。
使用場(chǎng)景: 用戶點(diǎn)擊商戶H5頁面提供的添加至卡包JS-SDK后,商戶根據(jù)用戶電影票信息,調(diào)用接口創(chuàng)建卡券,獲取card_id后,將帶有唯一Code碼的電影票下發(fā)給用戶,用戶領(lǐng)取后通過接口(更新電影票)update用戶選座信息。
接口調(diào)用請(qǐng)求說明
http請(qǐng)求方式: POSThttps://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
POST數(shù)據(jù) | 是 | Json數(shù)據(jù) |
{
"card": {
"card_type": "MOVIE_TICKET",
"movie_ticket": {
"base_info": {
},
"detail": "電影名:xxx,電影簡(jiǎn)介:xxx"
}
}
}
參數(shù)名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|
card_type | 是 | string(24) | MOVIE_TICKET | 電影票類型。 |
base_info | 是 | Json結(jié)構(gòu) | 見上述示例。 | 基本的卡券數(shù)據(jù),見下表,所有卡券通用。 |
detail | 是 | string(3072) | 電影名:xxx,電影簡(jiǎn)介:xxx。 | 電影票詳情 |
base_info字段
參數(shù)名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|
logo_url | 是 | string(128) | http://mmbiz.qpic.cn/ | 卡券的商戶logo,建議像素為300*300。 |
code_type | 是 | string(16) | CODE_TYPE_TEXT | Code展示類型,"CODE_TYPE_TEXT",文本;"CODE_TYPE_BARCODE",一維碼 ;"CODE_TYPE_QRCODE",二維碼;"CODE_TYPE_ONLY_QRCODE",二維碼無code顯示;"CODE_TYPE_ONLY_BARCODE",一維碼無code顯示; |
brand_name | 是 | string(36) | 電影票 | 商戶名字,字?jǐn)?shù)上限為12個(gè)漢字。 |
title | 是 | string(27) | 復(fù)仇者聯(lián)盟2 | 卡券名,字?jǐn)?shù)上限為9個(gè)漢字。(建議涵蓋卡券屬性、服務(wù)及金額)。 |
color | 是 | string(16) | Color010 | 券顏色。按色彩規(guī)范標(biāo)注填寫Color010-Color100。詳情見獲取顏色列表接口 |
notice | 是 | string(48) | 輸入兌換碼核銷 | 卡券使用提醒,字?jǐn)?shù)上限為16個(gè)漢字。 |
description | 是 | string(3072) | 不可與其他優(yōu)惠同享。 | 卡券使用說明,字?jǐn)?shù)上限為1024個(gè)漢字。 |
sku | 是 | Json結(jié)構(gòu) | 見上述示例。 | 商品信息。 |
quantity | 是 | int | 100000 | 卡券庫存的數(shù)量,不支持填寫0,上限為100000000。 |
date_info | 是 | Json結(jié)構(gòu) | 見上述示例。 | 使用日期,有效期的信息。 |
type | 是 | int | 1 | 使用時(shí)間的類型,僅支持填寫1或2。1為固定日期區(qū)間,2為固定時(shí)長(自領(lǐng)取后按天算)。 |
begin_timestamp | 否 | unsigned int | 14300000 | type為1時(shí)專用,表示起用時(shí)間。從1970年1月1日00:00:00至起用時(shí)間的秒數(shù),最終需轉(zhuǎn)換為字符串形態(tài)傳入。(東八區(qū)時(shí)間,單位為秒) |
end_timestamp | 否 | unsigned int | 15300000 | type為1時(shí)專用,表示結(jié)束時(shí)間,建議設(shè)置為截止日期的23:59:59過期。(東八區(qū)時(shí)間,單位為秒) |
fixed_term | 否 | int | 0 | type為2時(shí)專用,表示自領(lǐng)取后多少天內(nèi)有效,領(lǐng)取后當(dāng)天有效填寫0。(單位為天) |
fixed_begin_term | 否 | int | 15 | type為2時(shí)專用,表示自領(lǐng)取后多少天開始生效。(單位為天) |
use_custom_code | 否 | bool | true | 是否自定義Code碼。填寫true或false,默認(rèn)為false。通常自有優(yōu)惠碼系統(tǒng)的開發(fā)者選擇自定義Code碼,在卡券投放時(shí)帶入。 |
bind_openid | 否 | bool | true | 是否指定用戶領(lǐng)取,填寫true或false。默認(rèn)為false。 |
service_phone | 否 | string(24) | 40012234 | 客服電話。 |
location_id_list | 否 | array | 1234,2312 | 門店位置ID。調(diào)用POI門店管理接口獲取門店位置ID。 |
source | 否 | string(36) | 大眾點(diǎn)評(píng) | 第三方來源名,例如同程旅游、大眾點(diǎn)評(píng)。 |
custom_url_name | 否 | string(15) | 立即使用 | 自定義跳轉(zhuǎn)外鏈的入口名字。 |
custom_url | 否 | string(128) | "xxxx.com" | 自定義跳轉(zhuǎn)的URL。 |
custom_url_sub_title | 否 | string(18) | 更多驚喜 | 顯示在入口右側(cè)的提示語。 |
promotion_url_name | 否 | string(15) | 產(chǎn)品介紹 | 營銷場(chǎng)景的自定義入口名稱。 |
promotion_url | 否 | string(128) | XXXX.com | 入口跳轉(zhuǎn)外鏈的地址鏈接。 |
promotion_url_sub_title | 否 | string(18) | 賣場(chǎng)大優(yōu)惠。 | 顯示在營銷入口右側(cè)的提示語。 |
get_limit | 否 | int | 1 | 每人可領(lǐng)券的數(shù)量限制。 |
can_share | 否 | bool | false | 卡券領(lǐng)取頁面是否可分享。 |
can_give_friend | 否 | bool | false | 卡券是否可轉(zhuǎn)贈(zèng)。 |
領(lǐng)取電影票后通過調(diào)用“更新電影票”接口update電影信息及用戶選座信息。
接口調(diào)用請(qǐng)求說明
http請(qǐng)求方式: POSThttps://api.weixin.qq.com/card/movieticket/updateuser?access_token=TOKEN
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
POST數(shù)據(jù) | 是 | Json數(shù)據(jù) |
{
"code" : "277217129962",
"card_id": "p1Pj9jr90_SQRaVqYI239Ka1erkI",
"ticket_class": "4D",
"show_time": 1408493192,
"duration":120,
"screening_room": "5號(hào)影廳",
"seat_number": [ "5 排14 號(hào)" , "5排15號(hào)" ]
}
參數(shù)名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|
code | 是 | string(20) | 1231123 | 卡券Code碼。 |
card_id | 是 | string(32) | 持白金會(huì)員卡到店消費(fèi),可享8折優(yōu)惠。 | 要更新門票序列號(hào)所述的card_id,生成券時(shí)use_custom_code填寫true時(shí)必填。 |
ticket_class | 是 | string(12) | 2D | 電影票的類別,如2D、3D。 |
screening_room | 否 | string(12) | A廳 | 該場(chǎng)電影的影廳信息。 |
seat_number | 否 | string(12) | 5排10座 | 座位號(hào)。 |
show_time | 是 | unsigned int | 14300000 | 電影的放映時(shí)間,Unix時(shí)間戳格式。 |
duration | 是 | int | 120 | 放映時(shí)長,填寫整數(shù)。 |
返回說明
數(shù)據(jù)示例:
{
"errcode":0,
"errmsg":"ok"
}
參數(shù)名 | 描述 |
---|---|
errcode | 錯(cuò)誤碼,0為正常。 |
errmsg | 錯(cuò)誤信息。 |
飛機(jī)票與其他卡券相比具有更強(qiáng)的時(shí)效性和特殊性,故機(jī)票生成后無需經(jīng)過微信審核,即時(shí)生效。 機(jī)票使用場(chǎng)景主要分為以下兩種:
1、通過微信購買后直接添加至卡包,可值機(jī)時(shí)段由卡包在線辦理登機(jī)牌。
2、在微信商戶(一般為航空公司)公眾號(hào)內(nèi)完成值機(jī)后,添加至微信卡包。
第一種場(chǎng)景: 用戶點(diǎn)擊商戶H5頁面“添加至卡包”后,商戶根據(jù)用戶機(jī)票信息,調(diào)用接口創(chuàng)建卡券,獲取card_id后,將機(jī)票下發(fā)給用戶。在可值機(jī)時(shí)段,用戶點(diǎn)擊商戶指定的URL在線辦理登機(jī)牌。辦理成功后,商戶調(diào)用更新機(jī)票信息接口,將值機(jī)信息同步。
第二種場(chǎng)景: 用戶點(diǎn)擊商戶H5頁面提供的JS API后,商戶根據(jù)用戶機(jī)票信息,調(diào)用接口生成卡券,獲取card_id后,將機(jī)票下發(fā)給用戶。并立即更新機(jī)票接口,將值機(jī)信息同步。
創(chuàng)建飛機(jī)票接口
接口調(diào)用請(qǐng)求說明
HTTPS請(qǐng)求方式: POST
URL:https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
POST數(shù)據(jù) | 是 | Json數(shù)據(jù) |
{
"card": {
"card_type": "BOARDING_PASS",
"boarding_pass": {
"base_info": {
xxxxxxxxxxxxxxxxxxxx
xxxxxxxxxxxxxxxxxxxxx
},
"from": "成都",
"to": "廣州",
"flight": "CE123",
"departure_time": "1434507901",
"landing_time": "1434909901",
"air_model": "空客A320"
}
}
}
機(jī)票專屬字段:
參數(shù)名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|
card_type | 是 | string(24) | BOARDING_PASS | 飛機(jī)票類型。 |
base_info | 是 | JSON結(jié)構(gòu) | 見示例 | 基本的卡券數(shù)據(jù),所有卡券通用,詳細(xì)字段見下表。 |
from | 是 | string(54) | 成都 | 起點(diǎn),上限為18個(gè)漢字。 |
to | 是 | string(54) | 廣州 | 終點(diǎn),上限為18個(gè)漢字。 |
flight | 是 | string(24) | CE123 | 航班 |
gate | 否 | string(12) | A11 | 入口,上限為4個(gè)漢字。 |
check_in_url | 否 | string(128) | xxx.com | 在線值機(jī)的鏈接。 |
air_model | 是 | string(24) | 空客A320 | 機(jī)型,上限為8個(gè)漢字。 |
departure_time | 是 | string(128) | 1434507901 | 起飛時(shí)間。Unix時(shí)間戳格式。 |
landing_time | 是 | string(128) | 1434909901 | 降落時(shí)間。Unix時(shí)間戳格式。 |
返回說明
數(shù)據(jù)示例:
{
"errcode":0,
"errmsg":"ok",
"card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
參數(shù)名 | 描述 |
---|---|
errcode | 錯(cuò)誤碼,0為正常。 |
errmsg | 錯(cuò)誤信息。 |
card_id | 卡券ID。 |
接口調(diào)用請(qǐng)求說明
http請(qǐng)求方式: POSThttps://api.weixin.qq.com/card/boardingpass/checkin?access_token=TOKEN
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
POST數(shù)據(jù) | 是 | Json數(shù)據(jù) |
{
"code": "198374613512",
"card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI",
"passenger_name": "乘客姓名",
"class": "艙等",
"seat": "座位號(hào)",
"etkt_bnr": "電子客票號(hào)",
"qrcode_data": "二維碼數(shù)據(jù)",
"is_cancel ": false
}
參數(shù)名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|
code | 是 | string(20) | 1231123 | 卡券Code碼。 |
card_id | 否 | string(32) | p1Pj9jr90_SQRaVqYI239Ka1erkI | 卡券ID,自定義Code碼的卡券必填。 |
etkt_bnr | 是 | string(14) | 1234567 | 電子客票號(hào),上限為14個(gè)數(shù)字。 |
class | 是 | string(15) | 經(jīng)濟(jì)艙。 | 艙等,如頭等艙等,上限為5個(gè)漢字。 |
qrcode_data | 否 | string(3072) | 12345 | 二維碼數(shù)據(jù)。乘客用于值機(jī)的二維碼字符串,微信會(huì)通過此數(shù)據(jù)為用戶生成值機(jī)用的二維碼。 |
seat | 否 | string(12) | 5排c號(hào) | 乘客座位號(hào)。 |
is_cancel | 否 | bool | false | 是否取消值機(jī)。填寫true或false。true代表取消,如填寫true上述字段(如calss等)均不做判斷,機(jī)票返回未值機(jī)狀態(tài),乘客可重新值機(jī)。默認(rèn)填寫false。 |
返回說明
數(shù)據(jù)示例:
{
"errcode":0,
"errmsg":"ok"
}
參數(shù)名 | 描述 |
---|---|
errcode | 錯(cuò)誤碼,0為正常。 |
errmsg | 錯(cuò)誤信息。 |
更多建議: