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.
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.
- Obtén un token de acceso de Azure AD para usarlo en el encabezado de la solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Si el token expira, puedes obtener uno nuevo.
Solicitud
Este método tiene la siguiente sintaxis. Consulta las siguientes secciones para ver ejemplos de uso y descripciones tanto del encabezado como del cuerpo de la solicitud.
Método | URI de solicitud |
---|---|
GET | https://manage.devcenter.microsoft.com/v1.0/my/applications |
Encabezado de solicitud
Encabezado | Tipo | Descripción |
---|---|---|
Authorization | string | Necesario. Token de acceso de Azure AD con el formato Token de portador<>. |
Parámetros de solicitud
Todos los parámetros de solicitud son opcionales para este método. Si llamas a este método sin parámetros, la respuesta contiene datos de las primeras 10 aplicaciones registradas en tu cuenta.
Parámetro | Tipo | Descripción | Obligatorio |
---|---|---|---|
top | int | El número de elementos que se devolverán en la solicitud (es decir, el número de aplicaciones que se devolverán). Si las aplicaciones de la cuenta superan el valor especificado en la consulta, el cuerpo de la respuesta incluye una ruta de acceso al URI relativa que puedes anexar al URI del método para solicitar la siguiente página de datos. | No |
skip | int | El número de elementos que se omitirán en la consulta antes de devolver los elementos restantes. Usa este parámetro para consultar conjuntos de datos. Por ejemplo, top = 10 y skip = 0 recuperan los elementos del 1 al 10, mientras que top = 10 y skip = 10 recuperan los elementos del 11 al 20, y así sucesivamente. | No |
Cuerpo de la solicitud
No incluyas un cuerpo de la solicitud para este método.
Ejemplos de solicitud
En el siguiente ejemplo se muestra cómo recuperar las 10 primeras aplicaciones registradas en tu cuenta.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications HTTP/1.1
Authorization: Bearer <your access token>
En el siguiente ejemplo se muestra cómo recuperar información sobre todas las aplicaciones registradas en tu 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 GET https://manage.devcenter.microsoft.com/v1.0/my/{@nextLink}
de forma recursiva hasta que {@nextlink}
sea null 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 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>
Response
En el siguiente ejemplo se muestra el cuerpo de respuesta JSON que devuelve una solicitud correcta para las 10 primeras aplicaciones registradas en una cuenta de desarrollador con un total de 21 aplicaciones. Para mayor brevedad, en este ejemplo se muestran solo los datos de las dos primeras aplicaciones que devuelve la solicitud. Para obtener más información acerca de los valores del cuerpo de respuesta, consulta la siguiente sección.
{
"@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
}
Response body
Valor | Tipo | Descripción |
---|---|---|
value | array | Una matriz de objetos que contienen información acerca de cada aplicación registrada en tu cuenta. Para obtener más información sobre los datos de cada objeto, consulta Recurso de aplicación. |
@nextLink | cadena | Si hay páginas adicionales de datos, esta cadena contiene una ruta de acceso relativa que se puede anexar al URI de la solicitud de base https://manage.devcenter.microsoft.com/v1.0/my/ para solicitar la siguiente página de datos. Por ejemplo, si el parámetro top del cuerpo de la solicitud inicial se establece en 10, pero hay 20 aplicaciones registradas en su cuenta, el cuerpo de la respuesta incluirá un @nextLink valor de applications?skip=10&top=10 , que indica que puede llamar https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 a para solicitar las 10 aplicaciones siguientes. |
totalCount | int | El número total de filas del resultado de datos de la consulta (es decir, el número total de aplicaciones registradas en tu 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 encontró ninguna aplicación. |
409 | Las aplicaciones usan características del Centro de partners que actualmente no son compatibles con la API de envío de Microsoft Store. |
Temas relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de