DB32T3413-2018 劇院數(shù)字化服務(wù)系統(tǒng)接口規(guī)范

ICS35.240

L77

備案號(hào)：60249-2018DB32

江蘇省地方標(biāo)準(zhǔn)

DB32/T3413—2018

劇院數(shù)字化服務(wù)系統(tǒng)接口規(guī)范

Interfacespecificationofdigitalservicesystemfortheaters

2018-06-25發(fā)布2018-07-10實(shí)施

江蘇省質(zhì)量技術(shù)監(jiān)督局發(fā)布

DB32/T3413—2018

劇院數(shù)字化服務(wù)系統(tǒng)接口規(guī)范

1范圍

本標(biāo)準(zhǔn)規(guī)定了劇院數(shù)字化服務(wù)系統(tǒng)建設(shè)中的通用信息交互要求和基本原則。

本標(biāo)準(zhǔn)適用于劇院數(shù)字化服務(wù)系統(tǒng)建設(shè)中的基礎(chǔ)接口設(shè)計(jì)、ERP系統(tǒng)接口設(shè)計(jì)、顧客平安系統(tǒng)接口

設(shè)計(jì)、微網(wǎng)站接口設(shè)計(jì)、會(huì)員卡管理系統(tǒng)接口設(shè)計(jì)、票務(wù)管理系統(tǒng)接口設(shè)計(jì)以及停車(chē)場(chǎng)管理系統(tǒng)接口設(shè)

計(jì)要求。

2規(guī)范性引用文件

下列文件對(duì)于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

GB/T8566-2007軟件生存周期過(guò)程

GB/T8567-2006計(jì)算機(jī)軟件文檔編制規(guī)范

GB/T11457-2006信息技術(shù)軟件工程術(shù)語(yǔ)

GB/T15126-2008信息技術(shù)開(kāi)放系統(tǒng)互連網(wǎng)絡(luò)服務(wù)定義

GB/T15532-2008計(jì)算機(jī)軟件測(cè)試規(guī)范

GB/T18726-2011現(xiàn)代設(shè)計(jì)工程集成技術(shù)的軟件接口規(guī)范

3術(shù)語(yǔ)和定義

下列術(shù)語(yǔ)和定義適用于本文件。

3.1

劇院數(shù)字化服務(wù)系統(tǒng)digitalservicesystemfortheaters

劇院數(shù)字化服務(wù)系統(tǒng)，是指通過(guò)以物聯(lián)網(wǎng)、云計(jì)算、大數(shù)據(jù)等新一代信息技術(shù)的應(yīng)用，達(dá)到提升劇

院顧客服務(wù)品質(zhì)，支撐強(qiáng)化劇院管理系統(tǒng)，完善劇院營(yíng)銷(xiāo)體系的目的。

3.2

接口interface

接口是計(jì)算機(jī)系統(tǒng)中兩個(gè)獨(dú)立的部件進(jìn)行信息交換的共享邊界。這種交換可以發(fā)生在計(jì)算機(jī)軟、硬

件，外部設(shè)備或進(jìn)行操作的人之間，也可以是它們的結(jié)合。

3.3

微網(wǎng)站micro-site

微網(wǎng)站指源于WebApp和網(wǎng)站的融合創(chuàng)新，兼容iOS、android、WP等各大操作系統(tǒng)，可以方便的與微

信、微博等應(yīng)用的鏈接，適應(yīng)移動(dòng)顧客端瀏覽市場(chǎng)對(duì)瀏覽體驗(yàn)與交互性能要求的新一代網(wǎng)站。

1

DB32/T3413—2018

4符號(hào)和縮略語(yǔ)

RFID(RadioFrequencyIdentification)射頻識(shí)別

APP（application）移動(dòng)應(yīng)用軟件

ERP(EnterpriseResourcePlanning)企業(yè)資源計(jì)劃

ID（identity）身份標(biāo)識(shí)號(hào)

OA（OfficeAutomation）辦公自動(dòng)化

URL（UniformResourceLocator）統(tǒng)一資源定位符

POI(PointofInterest)興趣點(diǎn)

UUID（UniversallyUniqueIdentifier）通用唯一識(shí)別碼

PKI/CA（PublicKeyInfrastructure/CertificateAuthority）

公鑰基礎(chǔ)設(shè)施/認(rèn)證中心

5信息交互接口

劇院數(shù)字化服務(wù)系統(tǒng)接口設(shè)計(jì)要求包括了基礎(chǔ)接口設(shè)計(jì)、ERP系統(tǒng)接口設(shè)計(jì)、顧客平安系統(tǒng)接口設(shè)

計(jì)、微網(wǎng)站接口設(shè)計(jì)、會(huì)員卡管理系統(tǒng)接口設(shè)計(jì)、票務(wù)管理系統(tǒng)接口設(shè)計(jì)、智能泊車(chē)系統(tǒng)接口設(shè)計(jì)等。

6基礎(chǔ)接口設(shè)計(jì)

6.1調(diào)用方式

采用WebService調(diào)用方式。

6.2獲取

6.2.1接口描述

Token是訪(fǎng)問(wèn)外部服務(wù)系統(tǒng)接口的全局唯一憑證,通過(guò)WebService方式訪(fǎng)問(wèn)獲取Token，客戶(hù)端系統(tǒng)

調(diào)用各接口時(shí)都需使用Token。

6.2.2輸入?yún)?shù)

輸入?yún)?shù)為：應(yīng)用ID、時(shí)間戳。

6.2.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息、應(yīng)用ID、時(shí)間戳、Token。

6.3獲取會(huì)員信息

6.3.1接口描述

根據(jù)會(huì)員編號(hào)、或者手機(jī)號(hào)碼、或者身份證號(hào)查詢(xún)會(huì)員信息。

6.3.2輸入?yún)?shù)

輸入?yún)?shù)為：會(huì)員編號(hào)、電話(huà)號(hào)碼、會(huì)員登錄名。

6.3.3輸出參數(shù)

2

DB32/T3413—2018

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息、會(huì)員編號(hào)、會(huì)員名稱(chēng)、會(huì)員登錄名、會(huì)員登錄ID、昵稱(chēng)、電話(huà)、

會(huì)員卡號(hào)、地址、身份證號(hào)、性別、出生日期、登記日期、郵箱、消費(fèi)總額、車(chē)牌號(hào)、興趣愛(ài)好、總積

分、會(huì)員狀態(tài)、會(huì)員等級(jí)、余額。

6.4會(huì)員注冊(cè)接口

6.4.1接口描述

調(diào)用外部服務(wù)系統(tǒng)提供的接口，將系統(tǒng)注冊(cè)的會(huì)員信息實(shí)時(shí)推送到外部服務(wù)系統(tǒng)進(jìn)行保存。

6.4.2輸入?yún)?shù)

輸入?yún)?shù)為：會(huì)員名稱(chēng)、會(huì)員密碼、電話(huà)、身份證號(hào)、郵箱。

6.4.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

6.5公司信息同步

6.5.1接口描述

當(dāng)OA系統(tǒng)中，分部（公司）信息發(fā)生變化（新增、更新、刪除等）后，調(diào)用外部服務(wù)系統(tǒng)提供的接

口及時(shí)的將分部變化信息推送至外部服務(wù)系統(tǒng)進(jìn)行同步更新。

6.5.2輸入?yún)?shù)

輸入?yún)?shù)為：操作類(lèi)型、數(shù)據(jù)集、公司ID、公司名稱(chēng)、上級(jí)公司ID、排序號(hào)、狀態(tài)。

6.5.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

6.6部門(mén)信息同步

6.6.1接口描述

當(dāng)OA系統(tǒng)中，部門(mén)信息發(fā)生變化（新增、更新、刪除等）后，調(diào)用外部服務(wù)系統(tǒng)提供的接口及時(shí)的

將部門(mén)變化信息推送至外部服務(wù)系統(tǒng)進(jìn)行同步更新。

6.6.2輸入?yún)?shù)

輸入?yún)?shù)為：操作類(lèi)型、數(shù)據(jù)集、部門(mén)ID、公司名稱(chēng)、上級(jí)部門(mén)ID、排序號(hào)、狀態(tài)、公司ID。

6.6.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

6.7人員信息同步

6.7.1接口描述

當(dāng)OA系統(tǒng)中，人員信息發(fā)生變化（新增、更新、刪除等）后，調(diào)用外部服務(wù)系統(tǒng)提供的接口及時(shí)的

將人員變化信息推送至外部服務(wù)系統(tǒng)進(jìn)行同步更新。

3

DB32/T3413—2018

6.7.2輸入?yún)?shù)

輸入?yún)?shù)為：操作類(lèi)型、數(shù)據(jù)集、分部、部門(mén)、員工工號(hào)、姓名、性別、崗位、直接上級(jí)、狀態(tài)、

辦公電話(huà)、移動(dòng)電話(huà)、其他電話(huà)、電子郵件、出生日期、籍貫、人員性質(zhì)、更改日期、登錄名、加密密

碼。

6.7.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

6.8崗位信息同步

6.8.1接口描述

當(dāng)OA系統(tǒng)中，崗位信息發(fā)生變化（新增、更新、刪除等）后，調(diào)用外部服務(wù)系統(tǒng)提供的接口及時(shí)的

將崗位變化信息推送至外部服務(wù)系統(tǒng)進(jìn)行同步更新。

6.8.2輸入?yún)?shù)

輸入?yún)?shù)為：操作類(lèi)型、數(shù)據(jù)集、崗位編碼、崗位名稱(chēng)、部門(mén)編碼、單位編碼。

6.8.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

7ERP系統(tǒng)接口設(shè)計(jì)

7.1獲取Token

7.1.1接口描述

Token是調(diào)用命令的全局唯一票據(jù)，接入系統(tǒng)調(diào)用各接口命令時(shí)都需使用Token。

7.1.2輸入?yún)?shù)

輸入?yún)?shù)為：應(yīng)用ID、應(yīng)用密鑰。

7.1.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息、應(yīng)用ID、時(shí)間戳、Token、過(guò)期狀態(tài)。

7.2商鋪信息同步

7.2.1接口描述

當(dāng)ERP系統(tǒng)中，商鋪信息發(fā)生變化（新增、更新、刪除等）后，調(diào)用外部服務(wù)系統(tǒng)提供的接口及時(shí)

的將商鋪?zhàn)兓畔⑼扑椭镣獠糠?wù)系統(tǒng)進(jìn)行同步更新。

7.2.2輸入?yún)?shù)

輸入?yún)?shù)為：操作類(lèi)型、數(shù)據(jù)集、商戶(hù)編碼、中文名稱(chēng)、英文名稱(chēng)、店招品牌、狀態(tài)、商戶(hù)地址、

商戶(hù)性質(zhì)、商戶(hù)圖片、優(yōu)惠信息、聯(lián)系方式。

7.2.3輸出參數(shù)

4

DB32/T3413—2018

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

7.3商品類(lèi)別信息同步

7.3.1接口描述

當(dāng)ERP系統(tǒng)中商品類(lèi)別信息發(fā)生變化（新增、更新、刪除等）后，調(diào)用外部服務(wù)系統(tǒng)提供的接口及

時(shí)的將商品類(lèi)別變化信息推送至外部服務(wù)系統(tǒng)進(jìn)行同步更新。

7.3.2輸入?yún)?shù)

輸入?yún)?shù)為：操作類(lèi)型、數(shù)據(jù)集、編碼、中文名稱(chēng)、英文名稱(chēng)、級(jí)次、最上級(jí)ID、父類(lèi)ID、標(biāo)簽狀

態(tài)。

7.3.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

7.4商品信息同步

7.4.1接口描述

當(dāng)ERP系統(tǒng)中，商品信息發(fā)生變化（新增、更新、刪除等）后，調(diào)用外部服務(wù)系統(tǒng)提供的接口及時(shí)

的將商品變化信息推送至外部服務(wù)系統(tǒng)進(jìn)行同步更新。

7.4.2輸入?yún)?shù)

輸入?yún)?shù)為：操作類(lèi)型、數(shù)據(jù)集、商品編碼、商品條碼、商品中文名稱(chēng)、商品英文名稱(chēng)、商品門(mén)店、

合同編號(hào)、商品狀態(tài)、開(kāi)始日期、結(jié)束日期、租戶(hù)編碼、商品類(lèi)別。

7.4.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

7.5消費(fèi)記錄信息同步

7.5.1接口描述

ERP系統(tǒng)將除了外部服務(wù)系統(tǒng)之外的消費(fèi)記錄信息通過(guò)數(shù)據(jù)接口及時(shí)推送到外部服務(wù)系統(tǒng)進(jìn)行同步

保存。

7.5.2輸入?yún)?shù)

輸入?yún)?shù)為：消費(fèi)記錄ID、租賃商戶(hù)的店鋪標(biāo)號(hào)、商場(chǎng)統(tǒng)一提供POS機(jī)號(hào)、小票序號(hào)、銷(xiāo)售日期、

類(lèi)別、系統(tǒng)中給定的每個(gè)商鋪的商品代碼、價(jià)格、數(shù)量、此小票總成交金額、付款方式、原收銀機(jī)號(hào)、

原交易流水號(hào)、現(xiàn)金信用卡、儲(chǔ)值卡、促銷(xiāo)券、手工、其他支付、會(huì)員編號(hào)、消費(fèi)類(lèi)別。

7.5.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

7.6實(shí)時(shí)消費(fèi)信息同步

7.6.1接口描述

5

DB32/T3413—2018

外部服務(wù)系統(tǒng)將用戶(hù)實(shí)時(shí)消費(fèi)記錄通過(guò)接口推送到ERP系統(tǒng)保存。

7.6.2輸入?yún)?shù)

輸入?yún)?shù)為：消費(fèi)記錄ID、租賃商戶(hù)的店鋪標(biāo)號(hào)、商場(chǎng)統(tǒng)一提供POS機(jī)號(hào)、小票序號(hào)、銷(xiāo)售日期、

類(lèi)別、系統(tǒng)中給定的每個(gè)商鋪的商品代碼、價(jià)格、數(shù)量、此小票總成交金額、付款方式、原收銀機(jī)號(hào)、

原交易流水號(hào)、現(xiàn)金信用卡、儲(chǔ)值卡、促銷(xiāo)券、手工、其他支付、會(huì)員編號(hào)、消費(fèi)類(lèi)別。

7.6.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

8顧客平安系統(tǒng)接口

8.1獲取高危預(yù)警事件信息接口

8.1.1接口描述

通過(guò)對(duì)各種環(huán)境、動(dòng)能、溫度、壓力、火災(zāi)、高危氣體（包括氣體成份、煙霧）數(shù)據(jù)信息等數(shù)據(jù)的

勘測(cè)和分析，當(dāng)發(fā)生高危情況時(shí)，智慧劇院系統(tǒng)-外部服務(wù)系統(tǒng)通過(guò)調(diào)用接口的方式，及時(shí)獲取預(yù)警信

息，同時(shí)將預(yù)警信息發(fā)布給安保及其他外圍系統(tǒng)，包括事件編號(hào)、事件名稱(chēng)、事件描述、事件等級(jí)、事

件發(fā)生時(shí)間、事件發(fā)生地點(diǎn)、事件類(lèi)型。

8.1.2輸入?yún)?shù)

輸入?yún)?shù)為：事件編號(hào)、事件名稱(chēng)、事件描述、事件等級(jí)、事件發(fā)生時(shí)間、事件發(fā)生地點(diǎn)、事件類(lèi)

型。

8.1.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

8.2獲取兒童走失告警信息接口

8.2.1接口描述

智慧劇院系統(tǒng)-外部服務(wù)系統(tǒng)通過(guò)調(diào)用接口的方式，及時(shí)獲取兒童走失信息，當(dāng)兒童接近劇院一些

關(guān)鍵出口時(shí)，通過(guò)RFID設(shè)備獲取兒童位置信息，包括時(shí)間、位置等信息。

8.2.2輸入?yún)?shù)

輸入?yún)?shù)為：編號(hào)、描述、時(shí)間、走失位置。

8.2.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

8.3獲取客流勘測(cè)信息接口

8.3.1接口描述

智慧劇院系統(tǒng)-外部服務(wù)系統(tǒng)通過(guò)調(diào)用接口的方式，獲取客流信息，包括客流密度、位置等信息。

6

DB32/T3413—2018

8.3.2輸入?yún)?shù)

輸入?yún)?shù)為：時(shí)間、位置。

8.3.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息、時(shí)間、位置、客流密度。

9微網(wǎng)站接口

9.1認(rèn)證簽名

認(rèn)證簽名的算法為：

（1）將需要參與認(rèn)證的請(qǐng)求參數(shù)按參數(shù)名升序排序。

（2）按請(qǐng)求參數(shù)名及參數(shù)值相互連接組成一個(gè)字符串：

<paramName1><paramValue1><paramName2><paramValue2>…；

（3）將應(yīng)用密鑰分別添加到以上請(qǐng)求參數(shù)串的頭部和尾部：<secret><請(qǐng)求參數(shù)字符串><secret>。

（4）對(duì)該字符串進(jìn)行SHA1運(yùn)算，得到一個(gè)二進(jìn)制數(shù)組；

（5）將該二進(jìn)制數(shù)組轉(zhuǎn)換為十六進(jìn)制的字符串，該字符串即是這些請(qǐng)求參數(shù)對(duì)應(yīng)的簽名。

9.2獲取微網(wǎng)站首頁(yè)信息接口

9.2.1獲取微網(wǎng)站的頁(yè)面幻燈片信息

9.2.1.1輸入?yún)?shù)

輸入?yún)?shù)為：認(rèn)證簽名、應(yīng)用標(biāo)識(shí)、手機(jī)唯一標(biāo)識(shí)、模塊ID、系統(tǒng)ID。

9.2.1.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

9.2.2獲取微網(wǎng)站的模塊信息

9.2.2.1輸入?yún)?shù)

輸入?yún)?shù)為：認(rèn)證簽名、應(yīng)用標(biāo)識(shí)、手機(jī)唯一標(biāo)識(shí)、系統(tǒng)ID、是否發(fā)布。

9.2.2.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、錯(cuò)誤信息。

9.3微網(wǎng)站訪(fǎng)問(wèn)統(tǒng)計(jì)接口

9.3.1接口描述

記錄商城訪(fǎng)問(wèn)。

9.3.2輸入?yún)?shù)

輸入?yún)?shù)為：認(rèn)證簽名、應(yīng)用標(biāo)識(shí)、手機(jī)唯一標(biāo)識(shí)、系統(tǒng)ID、用戶(hù)ID、類(lèi)型（微官網(wǎng)或微信）。

9.3.3輸出參數(shù)

7

DB32/T3413—2018

輸出參數(shù)為：狀態(tài)碼、返回信息。

9.4注冊(cè)/登錄

9.4.1驗(yàn)證手機(jī)或發(fā)送驗(yàn)證碼

9.4.1.1輸入?yún)?shù)

輸入?yún)?shù)為：認(rèn)證簽名、應(yīng)用標(biāo)識(shí)、手機(jī)唯一標(biāo)識(shí)、系統(tǒng)ID、接受驗(yàn)證碼的手機(jī)號(hào)碼。

9.4.1.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

9.4.2重新獲取驗(yàn)證碼

9.4.2.1輸入?yún)?shù)

輸入?yún)?shù)為：認(rèn)證簽名、應(yīng)用標(biāo)識(shí)、手機(jī)唯一標(biāo)識(shí)、系統(tǒng)ID、接受驗(yàn)證碼的手機(jī)號(hào)碼。

9.4.2.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

9.4.2登錄

9.4.2.1輸入?yún)?shù)

輸入?yún)?shù)為：認(rèn)證簽名、應(yīng)用標(biāo)識(shí)、手機(jī)唯一標(biāo)識(shí)、系統(tǒng)ID、接受驗(yàn)證碼的手機(jī)號(hào)碼、驗(yàn)證碼。

9.4.2.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

9.4.3核對(duì)驗(yàn)證碼

9.4.3.1輸入?yún)?shù)

輸入?yún)?shù)為：手機(jī)號(hào)碼、驗(yàn)證碼。

9.4.3.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

9.4.4綁定會(huì)員卡

9.4.4.1輸入?yún)?shù)

輸入?yún)?shù)為：手機(jī)號(hào)碼、會(huì)員卡號(hào)。

9.4.4.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

9.4.5注冊(cè)

9.4.5.1輸入?yún)?shù)

8

DB32/T3413—2018

輸入?yún)?shù)為：認(rèn)證簽名、應(yīng)用標(biāo)識(shí)、手機(jī)唯一標(biāo)識(shí)、系統(tǒng)id、手機(jī)號(hào)碼、用戶(hù)名、生日。

9.4.5.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

9.5劇院活動(dòng)管理接口

9.5.1獲取活動(dòng)列表

9.5.1.1輸入?yún)?shù)

輸入?yún)?shù)為：認(rèn)證簽名、應(yīng)用標(biāo)識(shí)、手機(jī)唯一標(biāo)識(shí)、系統(tǒng)ID、類(lèi)型（1.熱門(mén)活動(dòng)、2.商品活動(dòng)）、

頁(yè)碼（默認(rèn)第一頁(yè)）、頁(yè)長(zhǎng)度（默認(rèn)的記錄條數(shù)）、時(shí)間戳。

9.5.1.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

9.5.12獲取活動(dòng)詳細(xì)信息

9.5.2.1輸入?yún)?shù)

輸入?yún)?shù)為：認(rèn)證簽名、應(yīng)用標(biāo)識(shí)、手機(jī)唯一標(biāo)識(shí)、系統(tǒng)ID、活動(dòng)ID、用戶(hù)ID。

9.5.2.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

9.6劇院簡(jiǎn)介管理接口

9.6.1獲取劇院簡(jiǎn)介接口

9.6.1.1輸入?yún)?shù)

輸入?yún)?shù)為：認(rèn)證簽名、應(yīng)用標(biāo)識(shí)、手機(jī)唯一標(biāo)識(shí)、劇院簡(jiǎn)介ID、系統(tǒng)ID。

9.6.1.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

9.6.2獲取劇院內(nèi)容接口

9.6.2.1輸入?yún)?shù)

輸入?yún)?shù)為：認(rèn)證簽名、應(yīng)用標(biāo)識(shí)、手機(jī)唯一標(biāo)識(shí)、系統(tǒng)ID。

9.6.2.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

10會(huì)員卡管理系統(tǒng)接口

10.1會(huì)員卡信息同步接口

9

DB32/T3413—2018

當(dāng)會(huì)員卡管理系統(tǒng)中，會(huì)員卡信息發(fā)生變化（新增、更新、注銷(xiāo)等）后，調(diào)用外部服務(wù)系統(tǒng)提供的

接口，及時(shí)將會(huì)員卡變化信息推送至外部服務(wù)系統(tǒng)進(jìn)行同步更新。

10.1.1輸入?yún)?shù)

輸入?yún)?shù)為：操作類(lèi)型、數(shù)據(jù)集、會(huì)員編號(hào)、會(huì)員名稱(chēng)、公司名稱(chēng)、電話(huà)地址、會(huì)員卡號(hào)、身份證

號(hào)、性別、出生日期、登記日期、有效期限、總消費(fèi)額、總折扣額、總積分、會(huì)員狀態(tài)、會(huì)員等級(jí)、余

額。

10.1.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

10.2虛擬會(huì)員信息同步接口

虛擬會(huì)員與實(shí)體會(huì)員卡進(jìn)行綁定后，外部服務(wù)系統(tǒng)將變更的會(huì)員信息（積分、余額等）實(shí)時(shí)推送到

會(huì)員卡管理系統(tǒng)進(jìn)行同步保存更新。

10.2.1輸入?yún)?shù)

輸入?yún)?shù)為：會(huì)員編號(hào)、會(huì)員名稱(chēng)、公司名稱(chēng)、電話(huà)地址、會(huì)員卡號(hào)、身份證號(hào)、性別、出生日期、

登記日期、有效期限、總消費(fèi)額、總折扣額、總積分、會(huì)員狀態(tài)、會(huì)員等級(jí)、余額。

10.2.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

10.3會(huì)員消費(fèi)記錄接口

會(huì)員卡管理系統(tǒng)調(diào)用外部服務(wù)系統(tǒng)提供的接口，將會(huì)員卡消費(fèi)歷史記錄推送到外部服務(wù)系統(tǒng)。

10.3.1輸入?yún)?shù)

輸入?yún)?shù)為：消費(fèi)門(mén)店號(hào)、流水號(hào)、消費(fèi)時(shí)間、會(huì)員編號(hào)、商品編碼、專(zhuān)柜商號(hào)、商品類(lèi)別、消費(fèi)

類(lèi)別、零售單價(jià)、零售數(shù)量、優(yōu)惠金額、積分額、消費(fèi)金額。

10.3.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

10.4會(huì)員充值記錄接口

會(huì)員卡管理系統(tǒng)調(diào)用外部服務(wù)系統(tǒng)提供的接口，將會(huì)員卡的充值記錄實(shí)時(shí)推送到外部服務(wù)系統(tǒng)。

10.3.1輸入?yún)?shù)

輸入?yún)?shù)為：充值專(zhuān)柜號(hào)、流水號(hào)、充值時(shí)間、充值金額、充值前金額、充值后金額、充值渠道、

會(huì)員編號(hào)、積分額。

10.3.2輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

11票務(wù)系統(tǒng)接口

10

DB32/T3413—2018

11.1劇院排期接口

11.1.1接口描述

票務(wù)系統(tǒng)提供中間表，外部服務(wù)系統(tǒng)通過(guò)中間表查詢(xún)獲取劇院排期數(shù)據(jù)。票務(wù)系統(tǒng)為外部服務(wù)系統(tǒng)

提供劇院節(jié)目排期表結(jié)構(gòu)信息，并為其創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)用戶(hù)，分配該表的查詢(xún)權(quán)限。

11.1.2輸入?yún)?shù)

無(wú)。

11.1.3輸出參數(shù)

輸出參數(shù)：最低票價(jià)、最高票價(jià)、演出商品的編號(hào)、喜歡數(shù)、演出商品的編號(hào)、演出名稱(chēng)、項(xiàng)目狀

態(tài)（0售票中；1預(yù)售；2無(wú)效；3待定；4售完；5延期；6取消；7已結(jié)束(商品下架時(shí)自動(dòng)變更為此狀態(tài))）、

縮略圖地址（并非全地址URL）、場(chǎng)館編號(hào)、場(chǎng)館名稱(chēng)、開(kāi)始日期(格式：yyyy-MM-dd)、結(jié)束日期(格

式：yyyy-MM-dd)、創(chuàng)建時(shí)間（date）、一級(jí)分類(lèi)編號(hào)、一級(jí)分類(lèi)名稱(chēng)、二級(jí)分類(lèi)編號(hào)、二級(jí)分類(lèi)名稱(chēng)；

場(chǎng)館流水ID、場(chǎng)館名稱(chēng)、場(chǎng)館地址、場(chǎng)館推薦是否顯示(0不顯示，1顯示)；商品大類(lèi)別流水ID、商品

大類(lèi)別名稱(chēng)、商品大類(lèi)別序號(hào)（排序）；商品子類(lèi)別流水ID、商品子類(lèi)別名稱(chēng)、商品大類(lèi)別流水ID、

商品大類(lèi)別名稱(chēng)、商品子類(lèi)別序號(hào)（排序）。

11.2用戶(hù)購(gòu)票接口

11.2.1接口描述

外部服務(wù)系統(tǒng)與票務(wù)系統(tǒng)做界面集成，完成系統(tǒng)在線(xiàn)售票功能，票務(wù)系統(tǒng)提供售票訪(fǎng)問(wèn)的URL給外

部服務(wù)系統(tǒng)。

11.2.2輸入?yún)?shù)

無(wú)。

11.2.3輸出參數(shù)

輸出參數(shù)：節(jié)目編號(hào)

11.3我的訂單接口

11.3.1接口描述

票務(wù)系統(tǒng)提供中間表，外部服務(wù)系統(tǒng)通過(guò)中間表查詢(xún)我的訂單數(shù)據(jù)。票務(wù)系統(tǒng)為外部服務(wù)系統(tǒng)提供

我的訂單表結(jié)構(gòu)信息，并為其創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)用戶(hù)，分配該表的查詢(xún)權(quán)限。

11.3.2輸入?yún)?shù)

無(wú)。

11.3.3輸出參數(shù)

輸出參數(shù)：訂單編號(hào)、會(huì)員編號(hào)、訂單來(lái)源、訂單創(chuàng)建時(shí)間、訂單座位信息、訂單狀態(tài)、訂單支付

標(biāo)記、演出商品編號(hào)、演出商品名稱(chēng)、演出商品圖片、演出場(chǎng)館編號(hào)、演出場(chǎng)館名稱(chēng)、演出日期和時(shí)間、

訂單應(yīng)收、訂單實(shí)收、使用余額數(shù)、使用積分值、一級(jí)分類(lèi)編號(hào)、一級(jí)分類(lèi)名稱(chēng)、二級(jí)分類(lèi)編號(hào)、二級(jí)

分類(lèi)名稱(chēng)。

11

DB32/T3413—2018

11.4會(huì)員信息修改

11.4.1接口描述

用戶(hù)進(jìn)行訂單確認(rèn)時(shí)需要輸入用戶(hù)收獲地址，票務(wù)管理系統(tǒng)調(diào)用外部服務(wù)系統(tǒng)會(huì)員信息查詢(xún)接口查

詢(xún)會(huì)員地址，若沒(méi)有地址，用戶(hù)需要輸入新地址，此時(shí)票務(wù)管理系統(tǒng)調(diào)用外部服務(wù)系統(tǒng)會(huì)員信息修改接

口將會(huì)員地址推送到外部服務(wù)系統(tǒng)進(jìn)行保存。

11.4.2輸入?yún)?shù)

輸入?yún)?shù)：會(huì)員編號(hào)、身份證號(hào)、郵箱、地址。

11.4.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

11.5消費(fèi)余額同步

11.5.1接口描述

當(dāng)會(huì)員支付成功后，票務(wù)系統(tǒng)將用戶(hù)電子錢(qián)包支付扣減的金額同步到外部服務(wù)系統(tǒng)，同步扣減會(huì)

員的余額。

11.5.2輸入?yún)?shù)

輸入?yún)?shù)：會(huì)員編號(hào)、產(chǎn)生時(shí)間、金額、備注。

11.5.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

11.6電子錢(qián)包驗(yàn)證

11.6.1接口描述

會(huì)員支付訂單選擇用“電子錢(qián)包”支付時(shí)。需要驗(yàn)證“電子錢(qián)包”密碼是否正確。如果正確則返回

“成功”及實(shí)時(shí)余額，如果不正確則返回“失敗”。

11.6.2輸入?yún)?shù)

輸入?yún)?shù)：會(huì)員編號(hào)、電子錢(qián)包密碼。

11.6.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息、余額。

12智能泊車(chē)系統(tǒng)接口

12.1反向?qū)ぼ?chē)接口

12.1.1接口描述

12

DB32/T3413—2018

用戶(hù)通過(guò)手機(jī)APP點(diǎn)擊反向?qū)ぼ?chē)功能，停車(chē)場(chǎng)系統(tǒng)根據(jù)顧客輸入的車(chē)牌號(hào)，查詢(xún)車(chē)輛停車(chē)位置信息，

包含停車(chē)樓層、車(chē)輛停放區(qū)域（如A區(qū)、B區(qū)）、停車(chē)車(chē)位號(hào)等信息，與停車(chē)場(chǎng)地圖POI信息對(duì)應(yīng)，根據(jù)

路線(xiàn)規(guī)劃通過(guò)圖聚提供的導(dǎo)航引擎進(jìn)行導(dǎo)航，導(dǎo)航到停車(chē)位。

12.1.2輸入?yún)?shù)

輸入?yún)?shù)：車(chē)牌號(hào)。

12.1.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息、停車(chē)樓層、車(chē)輛停放區(qū)域、停車(chē)車(chē)位號(hào)余額。

12.2查詢(xún)空車(chē)位信息接口

12.2.1接口描述

用戶(hù)通過(guò)手機(jī)APP點(diǎn)擊空車(chē)位查詢(xún)按鈕，執(zhí)行空車(chē)位查詢(xún)操作，停車(chē)場(chǎng)管理系統(tǒng)將所有停車(chē)空位信

息（包括空車(chē)位總數(shù)、每一層和每個(gè)區(qū)域的空車(chē)位數(shù)量以及空車(chē)位對(duì)應(yīng)的地圖上具體位置）查出，在地

圖上顯示。

12.2.2輸入?yún)?shù)

無(wú)。

12.2.3輸出參數(shù)

輸出參數(shù)為：空車(chē)位總數(shù)、某層空車(chē)位數(shù)、某區(qū)域空車(chē)位數(shù)。

12.3空車(chē)位詳細(xì)信息接口

12.3.1接口描述

用戶(hù)通過(guò)手機(jī)APP點(diǎn)擊空車(chē)位查詢(xún)按鈕，執(zhí)行空車(chē)位查詢(xún)操作，停車(chē)場(chǎng)管理系統(tǒng)將所有停車(chē)空位信

息查出，在地圖上顯示。用戶(hù)通過(guò)APP選定某個(gè)空車(chē)位，停車(chē)場(chǎng)管理系統(tǒng)返回該空車(chē)位具體位置信息，

包括空車(chē)位的編號(hào)、坐標(biāo)等信息。根據(jù)定位用戶(hù)的位置及選定的空車(chē)位的坐標(biāo)，導(dǎo)航到該空車(chē)位。外部

服務(wù)系統(tǒng)通過(guò)傳入選定的空車(chē)位編號(hào)，與停車(chē)場(chǎng)系統(tǒng)做應(yīng)用集成。

12.3.2輸入?yún)?shù)

車(chē)位編號(hào)。

12.3.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息、空車(chē)位編號(hào)、空車(chē)位坐標(biāo)。

12.4獲取車(chē)輛失位接口

12.4.1接口描述

停車(chē)場(chǎng)管理系統(tǒng)判斷車(chē)輛移位，將車(chē)輛失位告警信息，包括車(chē)牌號(hào)、車(chē)位號(hào)、停車(chē)區(qū)域、失位告警

信息，通過(guò)調(diào)用外部服務(wù)系統(tǒng)提供的接口將車(chē)輛失位信息推送過(guò)來(lái)。

12.4.2輸入?yún)?shù)

13

DB32/T3413—2018

輸入?yún)?shù)：車(chē)位編號(hào)、停車(chē)區(qū)域、停放車(chē)位、進(jìn)入時(shí)間、告警信息。

12.4.3輸出參數(shù)

輸出參數(shù)為：狀態(tài)碼、返回信息。

12.5獲取無(wú)牌車(chē)接口

12.5.1