您好,登錄后才能下訂單哦!
靜態網站如何利用云函數SCF + API網關訪問自定義后端接口,相信很多沒有經驗的人對此束手無策,為此本文總結了問題出現的原因和解決方法,通過這篇文章希望你能解決這個問題。
小編介紹使用全靜態頁面的網站如何利用SCF+API 服務實現簡單的后端接口,并提供了一個 Python 出題器的實例演示。
相關服務介紹:
云函數(Serverless Cloud Function,SCF)是騰訊云為企業和開發者們提供的無服務器執行環境,幫助您在無需購買和管理服務器的情況下運行代碼。 API 網關(API Gateway)是 API 托管服務,提供 API 的完整生命周期管理,包括創建、維護、發布、運行、下線等。
前幾天為我家小盆友用 Python 寫了個簡單的自動數學題出題器,小家伙十分好奇,隔三差五的就要來讓我演示一番 。只是每次都要拿本出來輸命令給他看實在有些麻煩,于是想著能不能加個前端頁面調用,直接打開頁面就能看到運行效果。
作為一個行動派派,我目標鎖定了用 SCF+API 的方式,也就是現在很????的 serveless 方案。最大的好處當然是不用再伺候服務器了,少了很多搭建的麻煩。而且這個按實際使用量計費,對于小網站再適合不過了。
下面介紹下要怎么實現了。首先,你要有個騰訊云賬號,然后參考????的簡單步驟:
創建云函數 SCF。
創建 API Gateway,后臺指定調用步驟 1 建好的云函數。
API gateway中 新建密鑰,使用計劃,實現訪問控制并發布。
寫前端頁面,調用剛寫好的 API。
測試,解決各種 bug,大功告成!
照著這個文檔 云函數快速入門 按里面的步驟來創建自己業務函數。第一次可以選擇使用控制臺創建函數,運行環境中選擇自己熟悉的編程語言,當前支持 python, php, golang, java, nodejs 幾種,然后就可以在函數代碼下愉快的開始了。這里以運行環境 Python3.6 為例。默認的入口函數是 index.main_handler
,有兩個輸入參數:
event:可以獲取觸發源的消息 - 主要用來獲取傳入參數。
context:可以獲取本函數的環境及配置信息。
不清楚參數里有什么的,或怎么用的,可以直接打印出來看看,都是 dict 類型,一目了然。建議加上傳入參數檢查和限制,畢竟我們不知道調用接口的人會傳些什么奇怪的東西。返回類型包裝成 json 格式,對前端調用更友好。給出改好的代碼????:
# -*- coding: utf8 -*- import sys, getopt, random import json def main_handler(event, context): print("Received event: %s" % event) print("Received context: %s" % context) params = event["queryString"] return auto_cal_generator(int(params["limit"]), int(params["op_count"]), params["op_type"].split(","), int(params["total"])) def auto_cal_generator(limit=100, op_count=1, op_type=["+"], total=100): if limit>999 or op_count>9 or total>99: return "exceed max input limit" res = {} res["msg"] = "Here are today's %d works, good luck!" % total questions = [] l = len(op_type)-1 for j in range(0, total): up = limit question = "" for i in range(0, op_count+1): num = 0 if i == 0: num = random.randint(1,max(1,min(limit,up))) question = "%s%d" % (question, num) up -= num continue op = "+" if limit - up > 0: op_i = random.randint(0,l) op = op_type[op_i] question = "%s%s" % (question, op) if op =="+": num = random.randint(1,max(1,min(limit,up))) up -= num elif op == "-": num = random.randint(1,max(limit-up, 1)) up += num else: print("operator error: %s" % op) sys.exit(1) question = "%s%d" % (question, num) questions.append("%d: %s=" % (j+1, question)) res["questions"] = questions return json.dumps(res)
寫完 code 后當然不能忘了最重要的測試工作,代碼輸入框下就是測試的入口,需要創建測試模板。系統已經預置了好幾種模板類型,直接拿來改成你需要的就好。我們用 API Gateway 事件模板為原型修改剛寫好的出題器的測試模板。由于我們 code 獲取的是 event 里的 queryString
,這里只用修改里面的 queryString
這塊:
"queryString": { "op\_type" : "+,-", "op\_count" : 2, "limit":100, "total":10 },
創建完測試模板后,點擊左側測試,瞬間返回結果:
返回結果 "{\"msg\": \"Here are today's 10 works, good luck!\", \"questions\": \"1: 76-4-44=\", \"2: 52-42+67=\", \"3: 95+4-50=\", \"4: 84-78-1=\", \"5: 29-20-9=\", \"6: 19+37+38=\", \"7: 93-53+57=\", \"8: 80+7+7=\", \"9: 90-74-11=\", \"10: 7+34+52=\"}"
結果下方還有執行摘要和執行日志,方便調試。
云函數 SCF 寫完后,如果想要能通過網絡 http(s) 請求直接訪問,就要為其添加觸發方式為 API 網關觸發器。同時強烈建議將鑒權方法置為 API 網關密鑰對。然后就會在 API Gateway 下自動創建出一個對應的 service API。這一步如果遇到權限問題無法自動創建 API 的話,也不要著急,可以直接在 API gateway 的控制臺操作。
參考:API 網關快速入門。
創建 API 時注意將鑒權類型改成密鑰對。下方有個支持CORS的選項,如果需要跨域訪問就勾上,反之可以忽略。設置完需要接收的參數后,在下一步的后端配置中選后端類型為 cloud function 后,選中剛建好的云函數,就做好了這兩者的關聯。
建好 API 后,來到對應服務下的管理 API 標簽就能看到剛建好的 API。在列表的右側有調試入口,千萬不要忘了點進去做下測試。測試完成后,再到服務頁完成發布,這樣 API 就可以被訪問到了。
然后,就來到了相當重要但也容易被忽略的訪問控制這步。在前面我們已經選擇了密鑰對的方式作為鑒權類型。雖然有密鑰泄露的風險,但對于小網站來說這個驗證也是足夠了,記得保存好密鑰并定期修改就好。
之后的步驟就是創建密鑰對,創建使用計劃綁定密鑰對,再把使用計劃綁定服務或 API。下面直接甩出文檔:使用計劃。使用計劃中除了可以綁定密鑰對,還可以進行流量控制,可按需設置。
配置完后端服務后,要解決的就是訪問的問題了。由于沒錢供服務器,用的是靜態頁面托管的方式建的站。前端直接 ajax 訪問 API 來獲取結果。參考文檔在此:密鑰對認證,如何生成簽名(里面給出了用不同語言生成簽名的例子)。
由于沒寫前端好多年,對前端的認知還停留在 js 和 jquery 階段,這里只能給出改好的 jquery 寫法。用的是 crypto-js 加密。
//<script src="https://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.0.0/crypto-js.min.js"></script> function getHeader(){ var nowDate = new Date(); var dateTime = nowDate.toGMTString(); var SecretId = '****'; var SecretKey = '****'; var source = 'your_source'; var auth = "hmac id=\"" + SecretId + "\", algorithm=\"hmac-sha1\", headers=\"x-date source\", signature=\""; var signStr = "x-date: " + dateTime + "\n" + "source: " + source; var sign = CryptoJS.HmacSHA1(signStr, SecretKey) sign = CryptoJS.enc.Base64.stringify(sign) sign = auth + sign + "\"" var header = {"Source": source , "X-Date": dateTime , "Authorization":sign} return header } function getQ(){ $.ajax({ url: "https://xxxx/xx", type: "get", data:{ "op_count" : 1, "op_type" : "+,-", "limit" : 100, "total" : 10 }, dataType: "json", crossDomain: true, headers: getHeader(), success: function (data) { if (data.errorCode < 0){ //deal function error: data.errorMessage return } data= $.parseJSON(data); //show result in page }, error: function(jqXHR, textStatus, errorThrown){ //deal api error } }) }
如果在前面創建 API gateway 的 service 時候沒有指定自定義域名,或是自定義域名和調用頁面的域名不是同一個,就會涉及到跨域的問題。解決跨域問題傳統的方法可以用 jsonp。但它沒辦法在 request 的 Header 里加參數,也就傳不了鑒權所需的字段。所以這里只能用 CORS 來解決跨域:
對于服務端,只要前面建 API 的時候勾選了支持 CORS 選項,就會自動開啟,參考 API 控制臺相關問題 。對于客戶端,在 ajax 參數中設置 crossDomain: true
就可以了。
最后,解決一下頁面上的 bug,測試通過后就大功告成了!
看完上述內容,你們掌握靜態網站如何利用云函數SCF + API網關訪問自定義后端接口的方法了嗎?如果還想學到更多技能或想了解更多相關內容,歡迎關注億速云行業資訊頻道,感謝各位的閱讀!
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。