Experiment Management APIのバージョンエンドポイント

EUデータレジデンシー

このページの例では、デフォルトのベースURLhttps://experiment.amplitude.comを使用しています。プロジェクトでAmplitudeのEUデータセンターを使用している場合は、代わりにhttps://experiment.eu.amplitude.comを使用してください。詳細については、地域を参照してください。

リストのバージョン

bash

GET https://experiment.amplitude.com/api/1/versions

管理APIキーがアクセスできるすべての実験またはフラグのバージョンのリストを取得します。キーのスコープに含まれている場合、リストは複数のプロジェクトにわたります。

クエリパラメータ

名前	概要
`start`	返されるバージョンのISO 8601形式での開始時刻（この時刻を含む）。
`end`	返されるバージョンのISO 8601形式での終了時刻（この時刻を含まない）。
`limit`	返されるデプロイの最大数。上限は1000です。
`cursor`	結果の「ページ」を開始するためのオフセットです。

レスポンス

リクエストに成功すると、200 OKレスポンスが返されます。レスポンス本文には、バージョンのJSONリストと次のページへのカーソルが含まれています。

バージョンは作成時刻順で並べられます（降順）。

cURLの例

bash

curl --request GET \
    --url 'https://experiment.amplitude.com/api/1/versions?limit=3&cursor=3000&start=2023-01-01T00:00:00Z&end=2024-12-31T23:59:59Z' \
    --header 'Accept: application/json' \
    --header 'Authorization: Bearer <management-api-key>'

レスポンス例

json

    {
        "nextCursor": 3003,
        "versions": [
            {
                "createdAt": "2023-07-29T03:32:49.594Z",
                "createdBy": <userId>,
                "version": 3,
                "flagConfig": {
                    "id": <id>,
                    "projectId": <projectId>,
                    "deployments": [<deploymentId>],
                    "key": "flag-key",
                    "name": "flag-key",
                    "description": "feature flag access",
                    "enabled": true,
                    "evaluationMode": "remote",
                    "bucketingKey": "amplitude_id",
                    "bucketingSalt": "mHdQDzeE",
                    "bucketingUnit": "User",
                    "variants": [
                        {
                            "key": "on"
                        }
                    ],
                    "rolloutPercentage": 0,
                    "rolloutWeights": {
                        "on": 1
                    },
                    "targetSegments": [
                        {
                            "name": "Segment 1",
                            "conditions": [
                                {
                                    "prop": "country",
                                    "op": "is",
                                    "type": "property",
                                    "values": [
                                        "United States"
                                    ]
                                }
                            ],
                            "percentage": 0,
                            "bucketingKey": "amplitude_id",
                            "rolloutWeights": {
                                "on": 1
                            }
                        }
                    ]
                }
            },
            {
                "createdAt": "2023-07-29T03:32:39.494Z",
                "createdBy": <userId>,
                "version": 2,
                "flagConfig": {
                    "id": <id>,
                    "projectId": <projectId>,
                    "deployments": [<deploymentId>],
                    "key": "flag-key",
                    "name": "flag-key",
                    "description": "feature flag access",
                    "enabled": false,
                    "evaluationMode": "remote",
                    "bucketingKey": "amplitude_id",
                    "bucketingSalt": "mHdQDzeE",
                    "bucketingUnit": "User",
                    "variants": [
                        {
                            "key": "on"
                        }
                    ],
                    "rolloutPercentage": 0,
                    "rolloutWeights": {
                        "on": 1
                    },
                    "targetSegments": [
                        {
                            "name": "Segment 1",
                            "conditions": [
                                {
                                    "prop": "country",
                                    "op": "is",
                                    "type": "property",
                                    "values": [
                                        "United States"
                                    ]
                                }
                            ],
                            "percentage": 0,
                            "bucketingKey": "amplitude_id",
                            "rolloutWeights": {
                                "on": 1
                            }
                        }
                    ]
                }
            },
            {
                "createdAt": "2023-07-29T03:30:45.703Z",
                "createdBy": <userId>,
                "version": 1,
                "flagConfig": {
                    "id": <id>,
                    "projectId": <projectId>,
                    "deployments": [],
                    "key": "flag-key",
                    "name": "flag-key",
                    "description": "",
                    "enabled": false,
                    "evaluationMode": "remote",
                    "bucketingKey": "amplitude_id",
                    "bucketingSalt": "mHdQDzeE",
                    "bucketingUnit": "User",
                    "variants": [
                        {
                            "key": "on"
                        }
                    ],
                    "rolloutPercentage": 0,
                    "rolloutWeights": {
                        "on": 1
                    },
                    "targetSegments": []
                }
            }
        ]
    }

これは役に立ちましたか？