New translations webhook.md (Chinese Traditional)

This commit is contained in:
かっこかり 2023-12-31 13:28:30 +09:00
parent d07bd70000
commit 395f0fbc4a

View File

@ -1,64 +1,48 @@
# Webhook
:::tip
從 v12.109.0 新增的功能。
バージョン 12.109.0 以降の機能です。
:::
:::warning
由於這是一項試驗性功能,因此可能不穩定,或者將來規格可能會發生變化。
実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。
:::
Misskey 提供了 Webhook。使用 Webhook您可以即時接收 Misskey 上的各種事件
MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です
您可以在「設定」>「Webhook」中管理您的 Webhook
如果目標伺服器傳回 5xx 錯誤或無回應,則請求將在一段時間後重新傳輸
Webhook 註冊後,當指定事件發生時,將向指定 URL 傳送 HTTP 請求。請求方法為 POST內文為 JSON
此外請求標頭將包含您在註冊期間設定的金鑰名為「X-Misskey-Hook-Secret」。透過驗證此機密可以確定請求是否合法
Webhookが登録されると、指定したイベントが発生した際に、指定したURLにHTTPリクエストが送信されます。リクエストのメソッドはPOSTで、ボディはJSONです
さらに、リクエストヘッダーには`X-Misskey-Hook-Secret`という名前で、登録時に設定したシークレットが含まれます。このシークレットが正しいか検証することで、リクエストが正規のものか判定することができます
請求負載包含以下屬性。
リクエストペイロードは以下のプロパティが入ります。
提供每個事件的描述和負載。
送信先サーバーが5xxエラーを返すか、応答しなかった場合は時間を開けてリクエストが再送されます。
當您追隨某人時會發生。
## イベント
イベントごとに説明とペイロードを示します。
### follow
<MkSchemaViewerItemObject :schema="{
type: 'object',
properties: {
hookId: {
type: 'string',
description: 'Webhook ID',
},
userId: {
type: 'string',
description: 'Webhook作成者のユーザーID',
},
eventId: {
type: 'string',
description: 'イベントのID',
},
createdAt: {
type: 'integer',
description: 'イベントが発生した日時(UNIX time、ミリ秒)',
},
type: {
type: 'string',
description: 'イベントの種類',
},
body: {
type: 'object',
description: 'イベントのペイロード',
user: {
$ref: 'misskey://User',
description: 'フォローを行ったユーザー',
},
}
}"/>
如果目標伺服器傳回 5xx 錯誤或無回應,則請求將在一段時間後重新傳輸。
您可以從管理畫面單獨設定 Webhook 的活動狀態,並且可以暫時停止傳送請求。
## 事件
提供每個事件的描述和負載。
### follow
當您追隨某人時會發生。
<MkSchemaViewerItemObject :schema="{
type: 'object',
properties: {
@ -71,7 +55,15 @@ properties: {
### followed
當有人追隨您時發生。
<MkSchemaViewerItemObject :schema="{
type: 'object',
properties: {
user: {
$ref: 'misskey://User',
description: 'フォロー解除したユーザー',
},
}
}"/>
<MkSchemaViewerItemObject :schema="{
type: 'object',
@ -85,7 +77,15 @@ properties: {
### unfollow
當您取消追隨某人時會發生。 當您發布貼文時發生。
<MkSchemaViewerItemObject :schema="{
type: 'object',
properties: {
note: {
$ref: 'misskey://Note',
description: '作成されたノート',
},
}
}"/>
<MkSchemaViewerItemObject :schema="{
type: 'object',
@ -99,7 +99,15 @@ properties: {
### note
當您發布貼文時發生。
<MkSchemaViewerItemObject :schema="{
type: 'object',
properties: {
note: {
$ref: 'misskey://Note',
description: '返信',
},
}
}"/>
<MkSchemaViewerItemObject :schema="{
type: 'object',
@ -113,7 +121,15 @@ properties: {
### reply
當您回覆貼文時發生。
<MkSchemaViewerItemObject :schema="{
type: 'object',
properties: {
note: {
$ref: 'misskey://Note',
description: 'Renote',
},
}
}"/>
<MkSchemaViewerItemObject :schema="{
type: 'object',
@ -127,7 +143,15 @@ properties: {
### renote
當您自己的貼文被轉發時發生。
<MkSchemaViewerItemObject :schema="{
type: 'object',
properties: {
note: {
$ref: 'misskey://Note',
description: 'メンションを含むノート',
},
}
}"/>
<MkSchemaViewerItemObject :schema="{
type: 'object',
@ -141,7 +165,7 @@ properties: {
### mention
當有人提到你時發生
自分にメンションされた際に発生します
<MkSchemaViewerItemObject :schema="{
type: 'object',