Compartir a través de

Commit a package flight submission (Confirmar un envío de paquete piloto)

  • Artículo

Usa este método en la API de envío de Microsoft Store para confirmar un envío de paquete piloto nuevo o actualizado al Centro de partners. La acción de confirmación alerta al Centro de partners de que se han cargado los datos de envío (incluidos los paquetes relacionados). En respuesta, el Centro de partners confirma los cambios en los datos de envío para la ingesta y publicación. Una vez que la operación de confirmación se realiza correctamente, los cambios en el envío se muestran en el Centro de partners.

Para obtener más información sobre cómo encaja la operación de confirmación en el proceso de creación de un envío de paquete piloto mediante la API de envío de Microsoft Store, consulta Administrar envíos de paquetes piloto.

Requisitos previos

Para usar este método, primero debes hacer lo siguiente:

  • Si aún no lo ha hecho, complete todos los requisitos previos para la API de envío de Microsoft Store.
  • Consigue un token de acceso a Azure AD para utilizarlo en el encabezado de solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.
  • Cree un envío de paquete piloto y actualice el envío con los cambios necesarios en los datos de envío.

Solicitar

Este método tiene la sintaxis siguiente. Consulte las secciones siguientes para ver ejemplos de uso y descripciones del encabezado y el cuerpo de la solicitud.

Método URI de solicitud
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit

Encabezado de solicitud

Encabezado Tipo Descripción
Autorización string Necesario. Token de acceso de Azure AD con el formato Token<de portador>.

Parámetros de solicitud

Nombre Escribir Descripción
applicationId string Necesario. Id. de la Tienda de la aplicación que contiene el envío de paquete piloto que quieres confirmar. El identificador de la Tienda de la aplicación está disponible en el Centro de partners.
flightId string Necesario. Identificador del paquete piloto que contiene el envío que se va a confirmar. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un paquete piloto y obtener paquetes piloto para una aplicación. Para un vuelo creado en el Centro de partners, este identificador también está disponible en la dirección URL de la página piloto del Centro de partners.
submissionId string Necesario. Identificador del envío que se va a confirmar. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un envío de paquete piloto. Para un envío creado en el Centro de partners, este identificador también está disponible en la dirección URL de la página de envío en el Centro de partners.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Ejemplo de solicitud

En el ejemplo siguiente se muestra cómo confirmar un envío de paquete piloto.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/commit HTTP/1.1
Authorization: Bearer <your access token>

Respuesta

En el ejemplo siguiente se muestra el cuerpo de la respuesta JSON para una llamada correcta a este método. Para obtener más información sobre los valores en el cuerpo de la respuesta, consulte las secciones siguientes.

{
  "status": "CommitStarted"
}

Cuerpo de la respuesta

Valor Tipo Descripción
estado string El estado del envío. Este puede ser uno de los siguientes valores:
  • None
  • Canceled
  • PendingCommit
  • CommitStarted
  • CommitFailed
  • PendingPublication
  • Publicación
  • Publicado
  • PublishFailed
  • PreProcessing
  • PreProcessingFailed
  • Certificación
  • CertificationFailed
  • Versión
  • ReleaseFailed

Códigos de error

Si la solicitud no se puede completar correctamente, la respuesta contendrá uno de los siguientes códigos de error HTTP.

Código de error Description
400 Los parámetros de solicitud no son válidos.
404 No se encontró el envío especificado.
409 Se encontró el envío especificado, pero no se pudo confirmar en su estado actual, o la aplicación usa una característica del Centro de partners que actualmente no es compatible con la API de envío de Microsoft Store.