Obtener todas las aplicaciones

Usa este método en la API de envío de Microsoft Store para recuperar datos de las aplicaciones registradas en tu cuenta del Centro de partners.

Prerrequisitos

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

Si aún no lo ha hecho, complete todos los requisitos previos para la API de envío de Microsoft Store.
Obtenga un token de acceso de Azure AD para usarlo en el encabezado de solicitud para este método. Después de obtener un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.

Solicitud

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	Solicitud de URI
OBTENER	`https://manage.devcenter.microsoft.com/v1.0/my/applications`

Cabecera de solicitud

Cabecera	Tipo	Descripción
Autorización	cuerda / cadena	Obligatorio. El token de acceso de Azure AD en la forma Bearer<token>.

Parámetros de solicitud

Todos los parámetros de solicitud son opcionales para este método. Si llama a este método sin parámetros, la respuesta contiene datos de las primeras 10 aplicaciones registradas en su cuenta.

Parámetro	Tipo	Descripción	Obligatorio
Parte superior	Int	Número de elementos que se van a devolver en la solicitud (es decir, el número de aplicaciones que se van a devolver). Si su cuenta tiene más aplicaciones que el valor que especifique en la consulta, el cuerpo de la respuesta incluye una ruta de acceso URI relativa que puede anexar al URI del método para solicitar la siguiente página de datos.	No
saltarse	Int	Número de elementos que se van a omitir en la consulta antes de devolver los elementos restantes. Use este parámetro para paginar a través de conjuntos de datos. Por ejemplo, top=10 y skip=0 recupera los elementos del 1 al 10, top=10 y skip=10 recupera los elementos de 11 a 20, etc.	No

Cuerpo de la solicitud

No incluya un contenido de la solicitud para este método.

Solicitudes de ejemplo

En el ejemplo siguiente se muestra cómo recuperar las 10 primeras aplicaciones registradas en su cuenta.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications HTTP/1.1
Authorization: Bearer <your access token>

En el ejemplo siguiente se muestra cómo recuperar información sobre todas las aplicaciones registradas en su cuenta. En primer lugar, obtenga las 10 aplicaciones principales:

GET https://manage.devcenter.microsoft.com/v1.0/my/applications?top=10 HTTP/1.1
Authorization: Bearer <your access token>

A continuación, llame recursivamente a GET https://manage.devcenter.microsoft.com/v1.0/my/{@nextLink} hasta que {@nextlink} sea nulo o no exista en la respuesta. Por ejemplo:

GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=20&top=10 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=30&top=10 HTTP/1.1
Authorization: Bearer <your access token>

Si ya conoce el número total de aplicaciones que tiene en su cuenta, simplemente puede pasar ese número en el parámetro de superior para obtener información sobre todas las aplicaciones.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications?top=23 HTTP/1.1
Authorization: Bearer <your access token>

Respuesta

En el ejemplo siguiente se muestra el cuerpo de respuesta JSON devuelto por una solicitud correcta para las primeras 10 aplicaciones registradas en una cuenta de desarrollador con 21 aplicaciones totales. Por motivos de brevedad, en este ejemplo solo se muestran los datos de las dos primeras aplicaciones devueltas por la solicitud. Para obtener más información sobre los valores en el cuerpo de la respuesta, consulte la sección siguiente.

{
  "@nextLink": "applications?skip=10&top=10",
  "value": [
    {
      "id": "9NBLGGH4R315",
      "primaryName": "Contoso sample app",
      "packageFamilyName": "5224ContosoDeveloper.ContosoSampleApp_ng6try80pwt52",
      "packageIdentityName": "5224ContosoDeveloper.ContosoSampleApp",
      "publisherName": "CN=…",
      "firstPublishedDate": "2016-03-11T01:32:11.0747851Z",
      "pendingApplicationSubmission": {
        "id": "1152921504621134883",
        "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621134883"
      }
    },
    {
      "id": "9NBLGGH29DM8",
      "primaryName": "Contoso sample app 2",
      "packageFamilyName": "5224ContosoDeveloper.ContosoSampleApp2_ng6try80pwt52",
      "packageIdentityName": "5224ContosoDeveloper.ContosoSampleApp2",
      "publisherName": "CN=…",
      "firstPublishedDate": "2016-03-12T01:49:11.0747851Z",
      "lastPublishedApplicationSubmission": {
        "id": "1152921504621225621",
        "resourceLocation": "applications/9NBLGGH29DM8/submissions/1152921504621225621"
      }
      // Next 8 apps are omitted for brevity ...
    }
  ],
  "totalCount": 21
}

Cuerpo de respuesta

Importancia	Tipo	Descripción
valor	arreglo	Matriz de objetos que contienen información sobre cada aplicación registrada en su cuenta. Para obtener más información sobre los datos de cada objeto, vea recurso de la aplicación.
@nextLink	cuerda / cadena	Si hay páginas adicionales de datos, esta cadena contiene una ruta de acceso relativa que puede adjuntar a la URI base de la solicitud `https://manage.devcenter.microsoft.com/v1.0/my/` para solicitar la siguiente página de datos. Por ejemplo, si el parámetro de superior del cuerpo de la solicitud inicial está establecido en 10, pero hay 20 aplicaciones registradas en su cuenta, el cuerpo de la respuesta incluirá un valor @nextLink de `applications?skip=10&top=10`, que indica que puede llamar a `https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10` para solicitar las 10 aplicaciones siguientes.
conteo total	Int	Número total de filas del resultado de los datos de la consulta (es decir, el número total de aplicaciones registradas en la cuenta).

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	Descripción
404	No se encontraron aplicaciones.
409	Las aplicaciones usan características del Centro de partners que actualmente no son compatible s con la API de envío de Microsoft Store.

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-06-10