모든 앱 가져오기
Microsoft Store 제출 API에서 이 메서드를 사용하여 파트너 센터 계정에 등록된 앱에 대한 데이터를 검색합니다.
필수 조건
이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.
- 아직 완료하지 않은 경우 Microsoft Store 제출 API에 대한 모든 필수 조건을 완료합니다
- 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져옵니다. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.
Request
이 메서드의 구문은 다음과 같습니다. 헤더 및 요청 본문에 대한 사용 예시 및 설명은 다음의 섹션을 참조하세요.
| 메서드 | 요청 URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/applications |
요청 헤더
| 헤더 | 형식 | 설명 |
|---|---|---|
| 권한 부여 | string | 필수. Bearer<토큰> 형식의 Azure AD 액세스 토큰. |
요청 매개 변수
이 메서드에는 모든 요청 매개 변수가 선택 사항입니다. 매개 변수 없이 이 메서드를 호출하는 경우, 계정에 등록된 처음 10개 앱에 대한 데이터가 응답에 포함됩니다.
| 매개 변수 | 형식 | 설명 | 필수 |
|---|---|---|---|
| top | int | 요청에서 반환할 항목 수(즉, 반환할 앱의 수). 계정에 쿼리에서 지정한 값보다 더 많은 앱이 있는 경우, 응답 본문에는 메서드 URI에 추가하여 다음 데이터 페이지를 요청할 수 있는 상대 URI 경로가 포함됩니다. | 아니요 |
| skip | int | 남은 항목을 반환하기 전에 쿼리에서 바이패스할 항목 수입니다. 이 매개 변수를 사용하여 데이터 집합을 페이징합니다. 예를 들어 top=10 및 skip=0은 항목 1~10을 검색하고 top=10 및 skip=10은 항목 11~20을 검색하는 식으로 이어집니다. | 아니요 |
요청 본문
이 메서드에 대한 요청 본문을 제공하지 마세요.
요청 예제
다음 예제는 계정에 등록된 처음 10개의 앱을 검색하는 방법을 보여 줍니다.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications HTTP/1.1
Authorization: Bearer <your access token>
다음 예제는 계정에 등록된 모든 앱에 대한 정보를 검색하는 방법을 보여 줍니다. 먼저 상위 10개 앱을 가져옵니다.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?top=10 HTTP/1.1
Authorization: Bearer <your access token>
그런 다음 {@nextlink}(이)가 null이거나 응답에 존재하지 않을 때까지 GET https://manage.devcenter.microsoft.com/v1.0/my/{@nextLink}을(를) 재귀적으로 호출합니다. 예시:
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>
계정에 있는 앱의 총 수를 이미 알고 있는 경우 top 매개 변수에 해당 숫자를 전달하여 모든 앱에 대한 정보를 가져올 수 있습니다.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?top=23 HTTP/1.1
Authorization: Bearer <your access token>
Response
다음 예제는 총 21개의 앱이 있는 개발자 계정에 등록된 처음 10개의 앱에 대한 성공적인 요청으로 반환된 JSON 응답 본문을 보여 줍니다. 간단히 하기 위해 이 예제는 요청에서 반환된 처음 두 가지 앱에 대한 데이터만 보여 줍니다. 응답 본문의 값에 대한 세부 정보는 다음의 섹션을 참조하세요.
{
"@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
}
응답 본문
| 값 | 형식 | 설명 |
|---|---|---|
| 값 | 배열 | 계정에 등록된 각 앱에 대한 정보를 포함하는 개체의 배열. 각 개체의 데이터에 대한 자세한 정보는 애플리케이션 리소스를 참조하세요. |
| @nextLink | 문자열 | 데이터의 추가 페이지가 있는 경우, 이 문자열에는 다음 데이터 페이지를 요청하기 위해 기본 https://manage.devcenter.microsoft.com/v1.0/my/ 요청 URI에 추가할 수 있는 상대 경로가 포함됩니다. 예를 들어 초기 요청 본문의 top 매개 변수는 10으로 설정되어 있지만 계정에 등록된 앱이 20개인 경우 응답 본문에는 applications?skip=10&top=10의 @nextLink값이 포함되며 이는 https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10을(를) 호출하여 다음 10개의 앱을 호출할 수 있음을 나타냅니다. |
| totalCount | int | 쿼리에 대한 데이터 결과의 총 행 수(즉, 계정에 등록된 총 앱 수). |
오류 코드
요청을 성공적으로 완료할 수 없는 경우, 응답은 다음의 HTTP 오류 코드 중 하나를 포함합니다.
| 오류 코드 | 설명 |
|---|---|
| 404 | 앱을 찾을 수 없습니다. |
| 409 | 앱이 현재 Microsoft Store 제출 API에서 지원되지 않는 파트너 센터 기능을 사용합니다. |