Job Router Operations - Accept Job Offer

Servicio:

Communication

Versión de la API:

2023-11-01

Acepta una oferta para trabajar en un trabajo y devuelve un 409/Conflicto si otro agente ya aceptó el trabajo.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string	URI del recurso de comunicación
offerId	path	True	string	Id. de una oferta.
workerId	path	True	string	Id. de un trabajador.
api-version	query	True	string	Versión de API que se usará para la operación.

Respuestas

Nombre	Tipo	Description
200 OK	AcceptJobOfferResult	La solicitud se ha realizado correctamente.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Respuesta de error inesperada. Encabezados x-ms-error-code: string

Ejemplos

Accepts an offer to work on a job

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:

200

{
  "assignmentId": "246d5a06-c04a-4b6b-8a34-02bbd9fdad68",
  "jobId": "632f5345-220b-4e46-b31f-aeaf03cc2df9",
  "workerId": "DefaultWorker"
}

Definiciones

Nombre	Description
AcceptJobOfferResult	Respuesta que contiene identificadores para el trabajo, el trabajo y la asignación de una oferta aceptada.
Azure.Core.Foundations.Error	Objeto de error.
Azure.Core.Foundations.ErrorResponse	Una respuesta que contiene los detalles del error.
Azure.Core.Foundations.InnerError	Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

AcceptJobOfferResult

Respuesta que contiene identificadores para el trabajo, el trabajo y la asignación de una oferta aceptada.

Nombre	Tipo	Description
assignmentId	string	Identificador de asignación de trabajo que asigna un trabajo que ha aceptado una oferta a un trabajo.
jobId	string	Identificador del trabajo asignado.
workerId	string	Identificador del trabajo al que se ha asignado este trabajo.

Azure.Core.Foundations.Error

Objeto de error.

Nombre	Tipo	Description
code	string	Uno de los conjuntos de códigos de error definidos por el servidor.
details	Azure.Core.Foundations.Error[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror	Azure.Core.Foundations.InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Representación legible del error.
target	string	Destino del error.

Azure.Core.Foundations.ErrorResponse

Una respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	Azure.Core.Foundations.Error	Objeto de error.

Azure.Core.Foundations.InnerError

Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nombre	Tipo	Description
code	string	Uno de los conjuntos de códigos de error definidos por el servidor.
innererror	Azure.Core.Foundations.InnerError	Error interno.