次の記事は、自動翻訳技術を使用して自動的に翻訳されました。 コンピュータプログラムによって翻訳されているため、誤りがある場合があります。Adobeは、世界中の多くのユーザーがより多くの記事を利用できるように、翻訳版を提供しています。
翻訳の品質を評価してください。Translation by SYSTRAN


読み取りAPI

戻る:

この節では、APIのバージョン1の読み取りメソッドについて詳しく説明します。 概要についてはPhoneGap Build APIを、書き込みメソッドについてはPhoneGap Build Write APIを参照してください。

返答の例は、読みやすくするためにフォーマットされています。 実際のJSON応答には、大きな空白は含まれません。

APIの読み取りインターフェイスには、次のものが含まれます。

GET/api/v1/meユーザーのプロファイル とリソースを取得する

GET/api/v1/apps ユーザーのアプリを入手

GET/api/v1/apps/:id Get A User's App by Id

GET/api/v1/apps/:id/:platformプラットフォーム別のユーザーのアプリケーション ・ダウンロード

GET/api/v1/keysユーザのキーに関する Meta-dataを取得する

GET/api/v1/keys/:platformユーザーのプラットフォーム ・キーに関するメタデータを取得する

GET/api/v1/keys/:platform/:id 特定のキーに関するメタデータを取得する

https://build.phonegap.com/api/v1/meを入手

認証されたユーザーのJSONエンコードされた表現と、関連するリソースのリストを取得します。

これは、PhoneGap Build APIを通過するアプリケーションの開始点である必要があります。 これはhttps://build.phonegap.com/api/v1にエイリアス されます

$ curl -u andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/me
{
    "id": 1,
    "username":"alunny",
    "email":"andrew.lunny@nitobi.com",
    "apps": {
        "id": 2,
        "link": "/api/v1/apps",
        "all": [
            {
                "title": "A Single App",
                "role": "owner",
                "link": "/api/v1/apps/1234"
            }
        ]
    },
    "keys": {
        "ios": {
            "all":[
                {
                    "id": 34,
                    "default":true,
                    "title": "iOS Development Key",
                    "link": "/api/v1/keys/ios/34"
                },
                {
                    "id": 82,
                    "default":false,
                    "title": "iOS Distribution Key",
                    "link": "/api/v1/keys/ios/82"
                }
            ],
            "link":"/api/v1/keys/ios"
        },
        "android": {
            "all":[
                {
                    "id": 56,
                    "default":false,
                    "title": "Android Release Certificate",
                    "link": "/api/v1/keys/android/56"
                }
            ],
            "link":"/api/v1/keys/android"
        },
        "winphone": {
            "all": [
                {
                    "id": 72,
                    "title": "Windows Publisher Key",
                    "link": "/api/v1/keys/winphone/72",
                    "default": false
                }
            ],
            "link": "/api/v1/keys/winphone",
        }
        "link": "/api/v1/keys"
    },
    "link": "/api/v1/me"
}

https://build.phonegap.com/api/v1/appsを入手

認証されたユーザーのアプリケーションのJSONエンコードされた表現を取得します。

APIクライアントは、各アプリの link属性に従って 、関連する署名キーや共同作業者などの詳細を取得できます。

$ curl -u andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/apps
{
    "apps":[
        {
            "title":"My Index",
            "id":1,
            "package":"com.my.index",
            "version":"0.0.1",
            "repo":null,
            "description":"An Index of My Applications",
            "debug":false,
            "private":true,
            "link":"/api/v1/apps/1",
            "build_count":4,
            "phonegap_version":"cli-6.3.0",
            "hydrates":false,
            "status":{
                "android":"complete",
                "ios":null,
                "winphone":"pending"
            },
            "phonegap_versions":{
                "android":"5.2.1",
                "ios":"4.2.0",
                "winphone":"4.4.1"
            },
            "download":{
                "android":"/api/v1/apps/1/android",
            },
            "error":{
            },
            "icon":{
                "filename":"icon.png",
                "link":"/api/v1/apps/1/icon"
            },
            "role":"admin"
        },
        {
            "title":"PhoneGap: Getting Started",
            "id":2,
            "package":"com.phonegap.getting.started",
            "version":"1.0.0",
            "repo":"https://github.com/phonegap/phonegap-start.git",
            "description":"A template for getting started with
                    PhoneGap development and build.phonegap.com",
            "debug":false,
            "private":true,
            "share":true,
            "link":"/api/v1/apps/2",
            "phonegap_version":"cli-6.3.0",
            "build_count":12,
            "status": {
                "android":"complete",
                "ios":"complete",
                "winphone":"complete"
            },
            "phonegap_versions":{
                "android":"5.2.1",
                "ios":"4.2.0",
                "winphone":"4.4.1"
            },
            "download":{
                "android":"/api/v1/apps/1/android",
                "ios":"/api/v1/apps/1/ios",
                "winphone":"/api/v1/apps/1/winphone"
            },
            "error":{},
            "icon":{
                "filename":"big-icon.png",
                "link":"/api/v1/apps/2/icon"
            },
            "role":"admin"
        }
    ],
    "link":"/api/v1/apps"
}

https://build.phonegap.com/api/v1/apps/:idを入手

認証されたユーザーがアクセス権を持つ場合は、特定のアプリのJSONエンコードされた表現を取得します。

この詳細表示には、すべてのアプリケーションのリストに表示されるフィールドに加えて、次の項目が含まれます。

  • キー: アプリケーションの現在構築に使用されているすべてのキー。 これには、プラットフォームの所有者のデフォルトキーが含まれます(選択した場合)。

  • 共有者: 認証されたユーザーがアプリの所有者である場合は、このアプリにアクセスできる各ユーザーと、その役割。 PhoneGap buildに登録されている共有者は、アクティブな下に表 示され、 招待した共有者のうち、まだアカウントを作成していないものは、「保留中」と表示 されます

$ curl -u andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/apps/2
{
    "title":"PhoneGap: Getting Started",
    "id":2,
    "package":"com.phonegap.getting.started",
    "version":"1.0.0",
    "repo":"https://github.com/phonegap/phonegap-start.git",
    "description":"A template for getting started with
            PhoneGap development and build.phonegap.com",
    "debug":false,
    "private":true,
    "share":false,
    "link":"/api/v1/apps/2",
    "phonegap_version":"cli-6.3.0",
    "last_build":"2014-12-03 13:52:10 -0800",
    "build_count":12,
    "status": {
        "android":"complete",
        "ios":"complete",
        "winphone":"complete"
    },
    "phonegap_versions":{
        "android":"5.2.1",
        "ios":"4.2.0",
        "winphone":"4.4.1"
    },
    "download":{
        "android":"/api/v1/apps/1/android",
        "ios":"/api/v1/apps/1/ios",
        "winphone":"/api/v1/apps/1/winphone"
    },
    "error":{},
    "icon":{
        "filename":"big-icon.png",
        "link":"/api/v1/apps/2/icon"
    },
    "role":"admin",
    "keys":{},
    "collaborators":{
        "link":"/api/v1/apps/9/collaborators",
        "active":[
            {
                "id":9,
                "person":"andrew.lunny@nitobi.com",
                "role":"admin",
                "link":"/api/v1/apps/9/collaborators/9"
            },
            {
                "id":13,
                "person":"foo@bar.com",
                "role":"developer",
                "link":"/api/v1/apps/9/collaborators/13"
            }
        ],
        "pending":[
            {
                "person":"nobody@nitobi.com",
                "role":"tester"
            }
        ]
    }
}

アプリケーションが存在しない場合、またはアクセス権がない場合は、ステータスコード 404を示すエラーメッセージが返されます

$ curl -u andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/apps/520394
{
    "error":"app #54 not available"
}

https://build.phonegap.com/api/v1/apps/:id/:platformを入手

特定のプラットフォーム用のアプリケーションパッケージをダウンロードします。 使用可能なプラ ットフォームはandroidios、winphoneです。

成功した場合、このAPIメソッドは 302 リダイレクトをアプリケーションバイナリに返し、応答の本文はファイルのURLを参照します。

$ curl -Lu andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/apps/50/android
{
    "location":""http://s3.amazonaws.com/build.phonegap.com/some-long-guid/app.apk"
}

APIクライアントがリダイレクトを追跡できる場合は、応答を直接保存できます。

$ curl -Lu andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/apps/50/android > app_50.apk

ダウンロードする際は、適切なファイル拡張子が付いていることを確認します。

  • apk for Android
  • ipa for iOS
  • xap for Windows Phone

指定したプラットフォームでアプリケーションパッケージを使用できない場合は、ステータスコード 404:

$ curl -u andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/apps/52/android
{
    "error":"app #52 download unavailable for android"
}

https://build.phonegap.com/api/v1/keysを入手

アカウントに関連付けられたすべての署名キーのJSONエンコードされたリストを取得します。

これにより、関連するすべてのキーの短いリストが返されます。 /api/v1/meの要求時に表示されるリストに非常に近いものです

$ curl -u andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/keys
{
    "keys":{
        "ios":{
            "all":[
                {
                    "id":8,
                    "title":"My Dev Certificate",
                    "default":false,
                    "cert_name":"My_Dev_Cert.p12",
                    "provision":"My_Devices.mobileprovision",
                    "link":"/api/v1/keys/ios/8",
                    "role":"developer",
                    "locked":true
                }
            ],
            "link":"/api/v1/keys/ios"
        },
        "android":{
            "all":[
                {
                    "id":1,
                    "title":"Android Release Key",
                    "default":false,
                    "alias":"release",
                    "link":"/api/v1/keys/android/1",
                    "locked":true
                }
            ],
            "link":"/api/v1/keys/android"
        },
        "winphone":{
            "all":[
                {
                    "id": 72,
                    "title": "Windows Publisher Key",
                    "link": "/api/v1/keys/winphone/72",
                    "default": false
                }
            ],
            "link": "/api/v1/keys/winphone",
        }
    },
    "link":"/api/v1/keys"
}

https://build.phonegap.com/api/v1/keys/:platformを入手

特定のプラットフォーム向けに、アカウントに関連付けられたすべての署名キーのJSONエンコードされたリストを取得します。 このプラットフォームは iosandroidのいずれかです

$ curl -u andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/keys/ios
{
    "keys":[
        {
            "id":8,
            "title":"My Dev Certificate",
            "default":false,
            "cert_name":"My_Dev_Cert.p12",
            "provision":"My_Devices.mobileprovision"
            "link":"/api/v1/keys/ios/8",
            "role":"developer",
            "locked":true
        }
    ],
    "link":"/api/v1/keys/ios"
}

$ curl -u andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/keys/android
{
    "keys":[
        {
            "id":1,
            "title":"Android Release Key",
            "default":false,
            "alias":"releasing",
            "link":"/api/v1/keys/android/1",
            "locked":true
        }
    ],
    "link":"/api/v1/keys/android"
}

$ curl -u andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/keys/winphone
{
    "keys":[
        {
            "id": 72,
            "title": "Windows Publisher Key",
            "link": "/api/v1/keys/winphone/72",
            "default": false
        }
    ],
    "link":"/api/v1/keys/winphone"
}

https://build.phonegap.com/api/v1/keys/:platform/:idを入手

1つの署名キーのJSONエンコードされた表現を取得します。

$ curl -u andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/keys/ios/8
{
    "id":8,
    "title":"My Dev Certificate",
    "default":false,
    "cert_name":"My_Dev_Cert.p12",
    "provision":"My_Devices.mobileprovision"
    "link":"/api/v1/keys/ios/8",
    "role":"developer",
    "locked":true
}

$ curl -u andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/keys/android/1
{
    "id":1,
    "title":"Android Release Key",
    "default":false,
    "alias":"releasing",
    "link":"/api/v1/keys/android/1",
    "locked":true
}

$ curl -u andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/keys/winphone/72
{
    "id": 72,
    "title": "Windows Publisher Key",
    "link": "/api/v1/keys/winphone/72",
    "default": false
}

要求されたキーが使用できない場合は、 404 ステータスが返され、エラーメッセージがJSONとして表示されます。

$ curl -u andrew.lunny@nitobi.com https://build.phonegap.com/api/v1/keys/ios/8989898
{
    "error":"could not find ios key #8989898"
}
GitHubでこのページを編集
Copyright SYSTRAN 2016
この翻訳は役に立ちましたか?

Translation by SYSTRAN