Job Router Operations - Decline Job Offer

Dienst:

Communication

API-Version:

2023-11-01

Lehnt ein Angebot für die Arbeit an einem Arbeitsplatz ab.

POST {endpoint}/routing/workers/{workerId}/offers/{offerId}:decline?api-version=2023-11-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string	URI Ihrer Kommunikationsressource
offerId	path	True	string	ID eines Angebots.
workerId	path	True	string	ID eines Mitarbeiters.
api-version	query	True	string	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
retryOfferAt	string	Wenn "RetryOfferAt" nicht bereitgestellt wird, wird dieser Auftrag nicht erneut dem Arbeitnehmer angeboten, der diesen Auftrag abgelehnt hat, es sei denn, der Arbeitnehmer wird de-registriert und erneut registriert. Wenn eine RetryOfferAt-Zeit bereitgestellt wird, wird der Auftrag an berechtigte Mitarbeiter zur Wiederholungszeit in UTC erneut abgeglichen. Der Arbeitnehmer, der den Job abgelehnt hat, ist zu diesem Zeitpunkt auch für den Arbeitsplatz berechtigt.

Antworten

Name	Typ	Beschreibung
200 OK	object	Die Anforderung ist erfolgreich.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Unerwartete Fehlerantwort. Header x-ms-error-code: string

Sicherheit

AadOauth2Auth

Der Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize
Token-URL: https://login.microsoftonline.com/common/oauth2/token

Bereiche

Name	Beschreibung
https://communication.azure.com/.default

Beispiele

Declines an offer to work on a job

Beispielanforderung

HTTP

POST https://contoso.westus.communications.azure.com/routing/workers/DefaultWorker/offers/1d5896f3-8b54-40be-82d3-910323f5e2af:decline?api-version=2023-11-01

{
  "retryOfferAt": "2023-05-26T00:00:00.0000000Z"
}

Beispiel für eine Antwort

Statuscode:

200

{}

Definitionen

Name	Beschreibung
Azure.Core.Foundations.Error	Das Fehlerobjekt.
Azure.Core.Foundations.ErrorResponse	Eine Antwort, die Fehlerdetails enthält.
Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Microsoft One-API-Richtlinien – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
DeclineJobOfferOptions	Fordern Sie Nutzlast für degressierende Angebote an.

Azure.Core.Foundations.Error

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
details	Azure.Core.Foundations.Error[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innererror	Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine lesbare Darstellung des Fehlers.
target	string	Das Ziel des Fehlers.

Azure.Core.Foundations.ErrorResponse

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	Azure.Core.Foundations.Error	Das Fehlerobjekt.

Azure.Core.Foundations.InnerError

Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Microsoft One-API-Richtlinien – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
innererror	Azure.Core.Foundations.InnerError	Innerer Fehler.

DeclineJobOfferOptions

Fordern Sie Nutzlast für degressierende Angebote an.

Name	Typ	Beschreibung
retryOfferAt	string	Wenn "RetryOfferAt" nicht bereitgestellt wird, wird dieser Auftrag nicht erneut dem Arbeitnehmer angeboten, der diesen Auftrag abgelehnt hat, es sei denn, der Arbeitnehmer wird de-registriert und erneut registriert. Wenn eine RetryOfferAt-Zeit bereitgestellt wird, wird der Auftrag an berechtigte Mitarbeiter zur Wiederholungszeit in UTC erneut abgeglichen. Der Arbeitnehmer, der den Job abgelehnt hat, ist zu diesem Zeitpunkt auch für den Arbeitsplatz berechtigt.