共用方式為

Events - Reward

  • 參考
服務:
Azure AI Services
API 版本:
v1.0

報告獎勵，以配置給指定事件的最高排名動作。

POST {Endpoint}/personalizer/v1.0/events/{eventId}/reward

URI 參數

名稱 位於 必要 類型 Description
Endpoint
 path True

string

支援的認知服務端點。
eventId
 path True

string

maxLength: 256

此獎勵適用的事件標識碼。

要求標頭

名稱 必要 類型 Description
Ocp-Apim-Subscription-Key True

string

要求本文

名稱 必要 類型 Description
value True

number (float)

要指派給動作的獎勵。 值應介於 -1 與 1 之間。

回應

名稱 類型 Description
204 No Content

成功
Other Status Codes

ErrorResponse

無效的獎勵要求。

安全性

Ocp-Apim-Subscription-Key

類型: apiKey
位於: header

範例

Successful Events_Reward request

範例要求

POST {Endpoint}/personalizer/v1.0/events/id/reward


{
  "value": 1
}

範例回覆

狀態碼:
204

定義

名稱 Description
ErrorCode

高階錯誤碼。
ErrorResponse

用來將錯誤傳回給用戶端
InternalError

物件，包含與錯誤相關父物件更明確的資訊。
PersonalizerError

error 物件。
RewardRequest

給予排名回應的獎勵。

ErrorCode

列舉型別

高階錯誤碼。

值 Description
BadRequest

伺服器無法理解要求。
InternalServerError

伺服器上發生一般錯誤。
ResourceNotFound

要求的資源不存在於伺服器上。

ErrorResponse

Object

用來將錯誤傳回給用戶端

名稱 類型 Description
error

PersonalizerError

error 物件。

InternalError

Object

物件，包含與錯誤相關父物件更明確的資訊。

名稱 類型 Description
code

string

詳細的錯誤碼。
innererror

InternalError

error 物件。

PersonalizerError

Object

error 物件。

名稱 類型 Description
code

ErrorCode

高階錯誤碼。
details

PersonalizerError[]

導致此錯誤之特定錯誤的詳細數據陣列。
innerError

InternalError

更精細的錯誤詳細數據。
message

string

說明服務所回報錯誤的訊息。
target

string

錯誤來源專案。

RewardRequest

Object

給予排名回應的獎勵。

名稱 類型 Description
value

number (float)

要指派給動作的獎勵。 值應介於 -1 與 1 之間。