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