Compartir a través de

Obtención de la solicitud de exportación de ganancias por identificador

  • Artículo

Obtiene el estado de una solicitud de exportación en cola existente.

Solicitud REST

GET https://api.partner.microsoft.com/v1.0/payouts/transactionhistory/{transactionHistoryRequestId}

Parámetros de solicitud

Nombre En Obligatorio Tipo Descripción
requestId Consultar True Guid Identificador de solicitud de exportación

Encabezado de solicitud

Nombre Obligatorio Tipo Descripción
Authorization Sí String Token de portador de autorización.
ms-correlationid No String Un rastreador de solicitudes interno. Cada solicitud genera un nuevo rastreador (GUID).
ms-requestid No String Identificador de idempotencia de solicitud.

Cuerpo de la solicitud

N/D

Carga de respuesta

La API devuelve el estado HTTP 200.

En función de la solicitud, la API puede devolver otro estado estándar que se muestra en los estados de respuesta de la API estándar:

Nombre Descripción
400 - Solicitud incorrecta Faltan datos o son incorrectos.
401 No autorizado El autor de la llamada no está autenticado y debe autenticarse con el servicio de API de asociado antes de realizar la primera llamada.
403 Prohibido El autor de la llamada no está autorizado para realizar la solicitud.
Error de servidor interno 500 La API o una de sus dependencias no pueden cumplir la solicitud. Vuelva a intentarlo más tarde.
404 No encontrado Recurso no disponible con parámetros de entrada.
429 Limitación de velocidad Demasiadas solicitudes del mismo tipo. Prueba después de algún tiempo.

La carga de respuesta de la API devuelve los siguientes atributos:

Nombre Opcional Descripción
Valor false Consulte la tabla siguiente para ver los posibles valores y acciones.

Valores y acciones posibles

Valor Acción del cliente
requestId Identificador de solicitud de la solicitud de exportación.
requestDateTime Fecha y hora de inicio de la solicitud de exportación.
requestPath Ruta de acceso de consulta de la solicitud de exportación.
requestQueryString Filtro usado como parte de la solicitud de exportación.
blobLocation Recurso de blob con token cuando el archivo de exportación está listo.
Estado Estado de la operación de exportación. Consulte la siguiente lista de valores posibles para el estado.

Valores posibles para el estado

  • En cola: la operación de exportación no se ha iniciado
  • Procesamiento: la operación de exportación está en curso
  • Error: error en la operación de exportación después de los reintentos, intente poner en cola una nueva solicitud.
  • Completado: la operación de exportación se completó y el archivo de exportación está listo para su descarga.