..接口協(xié)議說(shuō)明書(shū)編制:審核:批準(zhǔn):姓名：部門(mén)：姓名：部門(mén)：姓名：部門(mén)：受控狀態(tài)：發(fā)放號(hào)：2017-07-13發(fā)布2017-07-13實(shí)施..版權(quán)說(shuō)明本文件中出現(xiàn)的任何文字?jǐn)⑹觥⑽臋n格式、插圖、照片、方法、過(guò)程等內(nèi)容,除另有特別注明,版權(quán)均屬xxxx公司所有,受到有關(guān)產(chǎn)權(quán)及版權(quán)法保護(hù)。本文件及其附錄的知識(shí)產(chǎn)權(quán)歸xxxx公司所有。如無(wú)授權(quán),請(qǐng)勿復(fù)制或傳播。本文件將交付xx系統(tǒng)開(kāi)發(fā)使用,使用范圍僅局限于工程。修訂頁(yè)版本章節(jié)名稱(chēng)修訂內(nèi)容簡(jiǎn)述修訂日期00所有章節(jié)創(chuàng)建2017-08-16..目錄通信協(xié)議說(shuō)明書(shū)1目錄41引言51.1Restful介紹52中心服務(wù)器與播放控制器間通信協(xié)議52.1概述52.2用戶(hù)管理5登錄5..引言Restful介紹REpresentationalStateTransfer<REST>是一種架構(gòu)原則,其中將web服務(wù)視為資源,可以由其URL唯一標(biāo)識(shí)。RESTfulWeb服務(wù)的關(guān)鍵特點(diǎn)是明確使用HTTP方法來(lái)表示不同的操作的調(diào)用。REST的基本設(shè)計(jì)原則對(duì)典型CRUD操作使用HTTP協(xié)議方法：POST-創(chuàng)建資源GET-檢索資源PUT–更新資源DELETE-刪除資源.REST服務(wù)的主要優(yōu)勢(shì)在于：它們是跨平臺(tái)<Java、.net、PHP等高度可重用的,因?yàn)樗鼈兌家蕾?lài)基本HTTP協(xié)議。它們使用基本的XML/JSON,而不是復(fù)雜的SOAPXML,使用非常方便。中心服務(wù)器與播放控制器間通信協(xié)議概述云平臺(tái)中心服務(wù)器與播放控制器間的通信采用restful通信協(xié)議框架,云平臺(tái)作為restful服務(wù)器,播放控制器作為restful客戶(hù)端。登錄用戶(hù)管理登錄請(qǐng)求APIPOST/api/v1/login請(qǐng)求參數(shù)描述NameInTypeDescriptionaccountbodystringUseraccountpasswordbodystringUserpasswordencryption請(qǐng)求參數(shù)示例{"account":"admin","password":"md5<admin>"}回應(yīng)狀態(tài)碼狀態(tài)碼描述200-OK成功401-Unauthorized未授權(quán)403-Forbidden當(dāng)前用戶(hù)無(wú)權(quán)限503-ServiceUnavailable服務(wù)不可用回應(yīng)參數(shù)描述NameInTypeDescriptiontokenbodystringSessiontokenexpired_inbodyint時(shí)效,單位秒idbodyint用戶(hù)IDaccountbodystring賬號(hào)namebodystring名稱(chēng)descriptionbodystring描述statusbodyint用戶(hù)狀態(tài)0:禁用1：?jiǎn)⒂胾pdate_timebodystring更新時(shí)間,格式:"%Y%m%d%H%M%S"functionsbodyint[]功能權(quán)限Id數(shù)組回應(yīng)參數(shù)示例{"token":"69B3E86AEB5C278B5758B6F705E041C6","expired_in":60,"id":1,"account":"admi