애플리케이션 정보를 얻기 위해 AppStore Connect API 활용

6722 단어 iOS
모바일 2018의 다음날.

개시하다


2018년 WWDC가 발표한'App Store Connect API'는 며칠 전부터 이용할 수 있게 됐다.이 글은 사용 등록에서 실제 사용까지의 절차를 소개한다.
집필 시기(2018년 12월)에 마련된 API는 다음과 같다.
  • TestFlight
  • App의 베타 버전 건축, 테스트 기기 및 그룹 관리
  • 사용자 및 액세스
  • 사용자 초대, 사용자 권한 설정, 사용자 삭제
  • 보고서
  • 영업 보고서 및 재무 보고서 수령
  • 공급에 관해서는 가까운 시일 내에 공개할 것이다.또한 API 사용은 조직에 등록된 계정으로만 제한됩니다.

    1. 주요 메시지 게시


    이 API는 JWT(JSON WebToken) 인증을 사용합니다.머리글에서 토큰을 Authorization: Bearer (トークン) 형식으로 지정하고 API를 사용합니다.영패 문자열을 생성하려면 다음과 같은 키워드 정보가 필요합니다.
  • Issuer ID
  • 키 ID
  • PRIVATE KEY
  • 이러한 정보는 App Store Connect에 게시됩니다.릴리즈 단계는 다음과 같습니다.
  • App Store Connect에 액세스하고 사용자 및 액세스에서 키 탭(권한이 없을 경우 키 탭이 표시되지 않음)을 클릭합니다.
  • API를 처음 생성할 때 확인 화면이 뜨고 내용을 확인한 뒤'제출'버튼을 눌러 다음 화면으로 이동한다.
  • 위 화면에서 API 키 생성을 클릭하거나 + 버튼을 클릭하면 등록 화면이 표시됩니다.

    "접근"은 아래 드롭다운 메뉴에서 권한을 설정하고 "생성"단추를 누르면 키를 생성합니다.
  • 위 작업이 완료되면 연결에 사용할 정보를 발표합니다.API 키 다운로드를 클릭하여 PRIVATE KEY 파일을 다운로드합니다.이 파일은 한 번만 다운로드할 수 있으니 주의하세요.
  • 2. 영패 발행


    다음에 1에서 얻은 키로 영패 문자열을 생성합니다.토큰문자열은 헤더, 페이로드, 시그니처 세 가지 요소에 의해 정해진 규칙에 따라 가공된다."를 참고하십시오.문자열을 생성하기 위해 다양한 프로그래밍 언어가 오픈소스 라이브러리를 준비해 놓았고 이를 활용할 수 있다.예를 들어 Ruby는 다음 코드로 발행할 수 있다.
    createtoken.rb
    require "base64"
    require "jwt"
    
    ISSUER_ID = "[Issuer ID]欄に表示された文字列"
    KEY_ID = "[キーID]欄に表示された文字列"
    private_key = OpenSSL::PKey.read(File.read("ダウンロードしたPRIVATE KEYファイル名"))
    
    token = JWT.encode(
       {
        iss: ISSUER_ID,
        exp: Time.now.to_i + 20 * 60,  # トークンの有効期限は20分以内とAppleが規定している
        aud: "appstoreconnect-v1"      # audは appstoreconnect-v1 固定
       },
       private_key,
       "ES256",                        # 署名方式は ES256 固定
       header_fields={
         kid: KEY_ID
       }
    )
    puts token
    
    위의 파일을 저장하고 다음 명령을 사용하여 생성할 수 있습니다.
    $ ruby createtoken.rb
    
    다른 언어 라이브러리에 대해서는 사이트 축소판 그림를 참조하십시오.

    3. API 사용


    그럼 API를 실제로 사용하세요.이번에는 curl 명령으로 자신의 계정을 App Store Connect에 업로드하는 응용 프로그램 목록을 가져옵니다.
    # トークンを生成
    $ ruby createtoken.rb
    # APIを実行
    $ curl -v -H 'Authorization: Bearer (上記で得たトークン)' https://api.appstoreconnect.apple.com/v1/apps
    
    응답은 JSON으로 반환됩니다.키와 값은 다음과 같다.
  • data(1〜n)
  • type: 스마트폰 앱'apps'
  • id: 어플리케이션 ID,
  • attributes
  • name: 응용 프로그램 이름
  • bundleId: 번들 ID
  • sku : SKU
  • primaryLocale: 로켈
  • relationships
  • 사전 분리 및 테스트기 정보를 얻기 위한 API의 URL
  • 을 반환합니다.
  • links
  • self: 정보를 가져오는 API의 URL
  • links
  • self: 정보를 가져오는 API의 URL
  • createtoken.rb의 코드도 영패가 생성된 후 20분간 사용할 수 있음을 나타냈다.여러 개의 API를 실행하려면 첫 번째 단계에서 영패를 보내고 함께 API를 두드리면 같은 영패를 사용할 수 있다.HTTP 상태 401 오류가 만료되면 반환되므로 토큰을 다시 생성해야 합니다.

    최후


    추가 API에 대해서는 다음을 참조하십시오.API를 잘 활용하여 더욱 확실하고 효율적인 응용 프로그램 개발을 진행합시다.
  • TestFlight
  • https://developer.apple.com/documentation/appstoreconnectapi/testflight
  • Users
  • https://developer.apple.com/documentation/appstoreconnectapi/users
  • User Invitations
  • https://developer.apple.com/documentation/appstoreconnectapi/user_invitations
  • Sales and Finance Reports
  • https://developer.apple.com/documentation/appstoreconnectapi/sales_and_finance_reports
  • 좋은 웹페이지 즐겨찾기