微信小程序云開發(fā) API云函數(shù)

2022-05-12 17:06 更新

云函數(shù)

注意: HTTP API 途徑觸發(fā)云函數(shù)不包含用戶信息



云開發(fā) HTTP API 提供了以下云函數(shù)調(diào)用 API:

觸發(fā)云函數(shù):

invokeCloudFunction

本接口應(yīng)在服務(wù)器端調(diào)用,詳細說明參見服務(wù)端API。

觸發(fā)云函數(shù)。注意:HTTP API 途徑觸發(fā)云函數(shù)不包含用戶信息。

請求地址

POST https://api.weixin.qq.com/tcb/invokecloudfunction?access_token=ACCESS_TOKEN&env=ENV&name=FUNCTION_NAME

請求參數(shù)

屬性 類型 默認值 必填 說明
access_token string 接口調(diào)用憑證
env string 云開發(fā)環(huán)境ID
name string 云函數(shù)名稱
POSTBODY string 云函數(shù)的傳入?yún)?shù),具體結(jié)構(gòu)由開發(fā)者定義。

返回值

Object

返回的 JSON 數(shù)據(jù)包

屬性 類型 說明
errcode number 錯誤碼
errmsg string 錯誤信息
resp_data string 云函數(shù)返回的buffer

errcode 的合法值

說明 最低版本
0 請求成功
-1 系統(tǒng)錯誤
-1000 系統(tǒng)錯誤
40014 AccessToken 不合法
40101 缺少必填參數(shù)
41001 缺少AccessToken
42001 AccessToken過期
43002 HTTP METHOD 錯誤
44002 POST BODY 為空
85088 該APP未開通云開發(fā)
其他錯誤碼 云開發(fā)錯誤碼

示例代碼

curl -d '{}' \
'https://api.weixin.qq.com/tcb/invokecloudfunction?access_token=ACCESS_TOKEN&env=ENV&name=login'

返回數(shù)據(jù)示例

{
    "errcode": 0,
    "errmsg": "ok",
    "resp_data": "{\"event\":{\"userInfo\":{\"appId\":\"SAMPLE_APPID\"}},\"appid\":\"SAMPLE_APPID\"}"
}

Tips

  1. 使用本API觸發(fā)云函數(shù),在云函數(shù)中無法獲取OpenID等用戶相關(guān)信息,無法使用涉及用戶登錄態(tài)的其他API。
  2. 注意 POST BODY 部分會傳遞給云函數(shù)作為輸入?yún)?shù)。
  3. 由 HTTP API 觸發(fā)的云函數(shù)可以使用云調(diào)用。
  4. 由 HTTP API 觸發(fā)云函數(shù)的超時時間為5s,請注意云函數(shù)的執(zhí)行時間不能過長。


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號