GB∕T 40094.3-2021 電子商務(wù)數(shù)據(jù)交易 第3部分：數(shù)據(jù)接口規(guī)范

電子商務(wù)數(shù)據(jù)交易第3部分：數(shù)據(jù)接口規(guī)范國家市場監(jiān)督管理總局發(fā)布國家標(biāo)準(zhǔn)化管理委員會前言 2規(guī)范性引用文件 3術(shù)語、定義和縮略語 4數(shù)據(jù)接口方式 5數(shù)據(jù)接口要求 26證實(shí)方法 參考文獻(xiàn) 5本部分為GB/T40094的第3部分。Ⅲ電子商務(wù)數(shù)據(jù)交易第3部分：數(shù)據(jù)接口規(guī)范GB/T40094.1—2021電子商務(wù)數(shù)據(jù)交易第1部分：準(zhǔn)則GB/T40094.1—2021、GB/T40URL:統(tǒng)一資源定位符(UniformResourceL5數(shù)據(jù)接口要求5.1身份認(rèn)證數(shù)據(jù)需求方應(yīng)通過身份認(rèn)證申請后，按照數(shù)據(jù)交易平臺或數(shù)據(jù)提供方定義的數(shù)據(jù)接口獲取數(shù)據(jù)。相關(guān)要求應(yīng)包括但不限于：a)數(shù)據(jù)需求方通過用戶名/密碼向數(shù)據(jù)交易平臺請求身份認(rèn)證；b)通過認(rèn)證后，由數(shù)據(jù)交易平臺為數(shù)據(jù)需求方提供一個身份令牌；c)數(shù)據(jù)需求方按照數(shù)據(jù)交易平臺或數(shù)據(jù)提供方提供的接口方式、接口說明等要求來獲取數(shù)據(jù)，具體接口要求見5.2和5.3。文件接口是數(shù)據(jù)需求方購買數(shù)據(jù)后由數(shù)據(jù)交易平臺為其提供的下載地址，通過下載地址可獲取所購買的數(shù)據(jù)文件。文件接口說明應(yīng)包括但不限于：a)文件下載地址：可獲取到數(shù)據(jù)文件的URL地址；示例1:http://file.XXX/common_flowers/download?name=金錢兜&access_token=您申請的AC-b)文件類型：數(shù)據(jù)文件的存儲格式說明；c)文件大小：數(shù)據(jù)文件的存儲空間大小或數(shù)據(jù)量的描述；API接口是數(shù)據(jù)提供方通過數(shù)據(jù)交易平臺提供的數(shù)據(jù)獲取方式，數(shù)據(jù)需求方通過調(diào)用數(shù)據(jù)提供方定義的API接口獲取所購買的數(shù)據(jù)。API接口說明應(yīng)包括但不限于：a)接口名稱：交易數(shù)據(jù)主題內(nèi)容的簡要和概況性描述，名稱突出數(shù)據(jù)內(nèi)容指向的對象以及對象具d)請求方式：對數(shù)據(jù)進(jìn)行操作采用的類型，可采用GET或POST等方式；2e)請求示例：請求數(shù)據(jù)的接口地址示例說明；示例5:http://api.XXX/common_flowers/query?name=金錢兜&access_token=您申請的ACCESS-f)請求參數(shù)：訪問接口時必要的或可選的參數(shù)，說明參數(shù)名稱、類型、是否必填、示例值和描述說明等；其中，必要參數(shù)應(yīng)給出調(diào)用API所需的唯一身份令牌；示例6:是您申請的ACCESSTOKEN是g)返回結(jié)果：請求數(shù)據(jù)后，系統(tǒng)返回的請求結(jié)果。包括但不限于返回狀態(tài)代碼、返回消息說明和數(shù)據(jù)信息等內(nèi)容；返回結(jié)果可采用JSON(JS對象簡譜，JavaScriptObjectNotation)等格式；示例7:"message":"查詢成功""name":"金錢兜","latinName":"PolysciasbalfourianaBail"alias":"圓葉南洋森、圓葉福祿桐、金錢多多","classification":"灌木花卉","genera":"植物界被子植物門雙子葉植物綱傘形目五加科南洋參屬","floweringPeriod":"秋季冬季","briefIntroduction":"金錢兜因葉子像圓肚兜而得名，又叫金錢多中有一些陽光直射也可以。性喜高溫多濕，耐旱耐陰。姿態(tài)優(yōu)美，古色古香，適合布置于客廳、庭園、花圃，亦可作盆景欣賞。主供盆栽，庭園樹及綠籬。接觸其汁液，可能引起發(fā)紅疹；碰到口部時，有時會引起腫]h)返回字段說明：返回結(jié)果中數(shù)據(jù)信息的字段說明，包括但不限于字段的名稱、類型、示例值和描述說明等；示例8:PolysciasbalfourianaB拉丁名3圓葉南洋森、圓葉福祿桐、金錢多多別名植物界被子植物門科屬金錢兜因葉子像圓肚兜而得名簡介示例9:說明該IP已被禁用6.3數(shù)據(jù)交易平臺檢查數(shù)據(jù)提供方提供的文件接口和API接口是否