다음을 통해 공유

앱에 대한 패키지 플라이트 가져오기

  • 아티클

Microsoft Store 제출 API에서 이 메서드를 사용하여 파트너 센터 계정에 등록된 앱의 패키지 플라이트를 나열합니다. 패키지 플라이트에 대한 자세한 정보는 패키지 플라이트를 참조하세요.

필수 조건

이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.

  • 아직 완료하지 않은 경우 Microsoft Store 제출 API에 대한 모든 필수 조건을 완료합니다
  • 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져옵니다. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.

Request

이 메서드의 구문은 다음과 같습니다. 헤더 및 요청 본문에 대한 사용 예시 및 설명은 다음의 섹션을 참조하세요.

메서드 요청 URI
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights

요청 헤더

헤더 형식 설명
권한 부여 string 필수. Bearer<토큰> 형식의 Azure AD 액세스 토큰.

요청 매개 변수

속성 형식 설명 필수
applicationId 문자열 패키지 플라이트를 검색하려는 앱의 Store ID입니다. Store ID에 대한 자세한 정보는 앱 ID 세부 정보 보기를 참조하세요. 예
top int 요청에서 반환할 항목 수(즉, 반환할 패키지 플라이트의 수)입니다. 계정에 쿼리에서 지정한 값보다 더 많은 패키지 플라이트가 있는 경우, 응답 본문에는 메서드 URI에 추가하여 다음 데이터 페이지를 요청할 수 있는 상대 URI 경로가 포함됩니다. 아니요
skip int 남은 항목을 반환하기 전에 쿼리에서 바이패스할 항목 수입니다. 이 매개 변수를 사용하여 데이터 집합을 페이징합니다. 예를 들어 top=10 및 skip=0은 항목 1~10을 검색하고 top=10 및 skip=10은 항목 11~20을 검색하는 식으로 이어집니다. 아니요

요청 본문

이 메서드에 대한 요청 본문을 제공하지 마세요.

요청 예제

다음 예제는 앱에 대한 모든 패키지 플라이트를 나열하는 방법을 보여 줍니다.

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

다음의 예제는 앱에 대한 첫 패키지 플라이트를 나열하는 방법을 보여 줍니다.

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

Response

다음 예제는 총 3개의 패키지 플라이트가 있는 앱에 대한 첫 번째 패키지 플라이트의 성공적인 요청에 의해 반환된 JSON 응답 본문을 보여 줍니다. 응답 본문의 값에 대한 세부 정보는 다음의 섹션을 참조하세요.

{
  "value": [
    {
      "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
      "friendlyName": "myflight",
      "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
      },
      "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
      },
      "groupIds": [
        "1152921504606962205"
      ],
      "rankHigherThan": "Non-flighted submission"
    }
  ],
  "totalCount": 3
}

응답 본문

값 형식 설명
@nextLink 문자열 데이터의 추가 페이지가 있는 경우, 이 문자열에는 다음 데이터 페이지를 요청하기 위해 기본 https://manage.devcenter.microsoft.com/v1.0/my/ 요청 URI에 추가할 수 있는 상대 경로가 포함됩니다. 예를 들어 초기 요청 본문의 top 매개 변수는 2로 설정되어 있지만 앱의 패키지 플라이트가 4개인 경우 응답 본문에는 applications/{applicationid}/listflights/?skip=2&top=2의 @nextLink값이 포함되며 이는 https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2를 호출하여 다음 2개의 패키지 플라이트를 호출할 수 있음을 나타냅니다.
값 배열 지정된 앱의 패키지 플라이트 정보를 제공하는 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 정보는 플라이트 리소스를 참조하세요.
totalCount int 쿼리에 대한 데이터 결과의 총 행 수(즉, 지정된 앱의 총 패키지 플라이트 수)입니다.

오류 코드

요청을 성공적으로 완료할 수 없는 경우, 응답은 다음의 HTTP 오류 코드 중 하나를 포함합니다.

오류 코드 설명
404 패키지 플라이트를 찾을 수 없습니다.
409 앱이 현재 Microsoft Store 제출 API에서 지원되지 않는 파트너 센터 기능을 사용합니다.