跳轉到

取得 webhook

此 API 目前為 Beta 版。端點位於 /v1beta/ 之下。

GET https://generativelanguage.googleapis.com/v1beta/webhooks/{id}

取得特定的 Webhook。

參數

id: required string

要擷取的 webhook ID。

請求範例

curl -X GET "https://generativelanguage.googleapis.com/v1beta/webhooks/$WEBHOOK_ID" \
  -H "x-goog-api-key: $GEMINI_API_KEY"

回應

uri: required string

webhook 事件要傳送到的 URI。


subscribed_events: required string array

此 webhook 所訂閱的事件。可用事件:

  • batch.succeeded
  • batch.expired
  • batch.failed
  • interaction.requires_action
  • interaction.completed
  • interaction.failed
  • video.generated

name: string

選用。使用者提供的 webhook 名稱。


create_time: string

僅供輸出。webhook 建立時的時間戳記。


update_time: string

僅供輸出。webhook 上次更新時的時間戳記。


**signing_secrets**: `SigningSecret array` 僅供輸出。與此 webhook 關聯的簽章密鑰。 **truncated_secret**: `string` 僅供輸出。簽章密鑰的截斷版本。 **expire_time**: `string` 僅供輸出。簽章密鑰的到期日。

**state**: `string enum` 僅供輸出。webhook 的狀態。 可能的值: - `enabled`:webhook 已啟用。 - `disabled`:webhook 已由使用者停用。 - `disabled_due_to_failed_deliveries`:webhook 因傳送失敗而停用。

new_signing_secret: string

僅供輸出。webhook 的新簽章密鑰。僅在建立時填入。


id: string

僅供輸出。webhook 的 ID。

回應範例

{
  "uri": "string",
  "subscribed_events": [
    "string"
  ],
  "name": "string",
  "create_time": "string",
  "update_time": "string",
  "signing_secrets": [
    {
      "truncated_secret": "string",
      "expire_time": "string"
    }
  ],
  "state": "enabled",
  "new_signing_secret": "string",
  "id": "string"
}