Events - Reward

Dienst:

Cognitive Services - Personalizer

API-Version:

v1.0

Meldet eine Belohnung, die der ranghöchsten Aktion für das angegebene Ereignis zugeordnet werden soll

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
Endpoint	path	True	string	Unterstützter Cognitive Services-Endpunkt.
eventId	path	True	string	Die Ereignis-ID, für die diese Belohnung gilt.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Ocp-Apim-Subscription-Key	True	string

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
value	True	number	Belohnung, die einer Aktion zugewiesen werden soll. Der Wert sollte zwischen -1 und einschließlich 1 liegen.

Antworten

Name	Typ	Beschreibung
204 No Content		Erfolg
Other Status Codes	ErrorResponse	Ungültige Belohnungsanforderung.

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

Beispiele

Successful Events_Reward request

Beispielanforderung

HTTP

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


{
  "value": 1
}

Beispiel für eine Antwort

Statuscode:

204

Definitionen

Name	Beschreibung
ErrorCode	Allgemeiner Fehlercode.
ErrorResponse	Wird verwendet, um einen Fehler an den Client zurückzugeben.
InternalError	Ein Objekt, das spezifischere Informationen als das übergeordnete Objekt zum Fehler enthält.
PersonalizerError	Das Fehlerobjekt.
RewardRequest	Belohnung für eine Rangantwort.

ErrorCode

Allgemeiner Fehlercode.

Name	Typ	Beschreibung
BadRequest	string	Die Anforderung konnte vom Server nicht verstanden werden.
InternalServerError	string	Auf dem Server ist ein allgemeiner Fehler aufgetreten.
ResourceNotFound	string	Die angeforderte Ressource ist auf dem Server nicht vorhanden.

ErrorResponse

Wird verwendet, um einen Fehler an den Client zurückzugeben.

Name	Typ	Beschreibung
error	PersonalizerError	Das Fehlerobjekt.

InternalError

Ein Objekt, das spezifischere Informationen als das übergeordnete Objekt zum Fehler enthält.

Name	Typ	Beschreibung
code	string	Detaillierter Fehlercode.
innererror	InternalError	Das Fehlerobjekt.

PersonalizerError

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	ErrorCode	Allgemeiner Fehlercode.
details	PersonalizerError[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innerError	InternalError	Detailliertere Fehlerdetails.
message	string	Eine Meldung, die den vom Dienst gemeldeten Fehler erklärt.
target	string	Fehlerquellenelement.

RewardRequest

Belohnung für eine Rangantwort.

Name	Typ	Beschreibung
value	number	Belohnung, die einer Aktion zugewiesen werden soll. Der Wert sollte zwischen -1 und einschließlich 1 liegen.