실험 실험 API 관리 버전 엔드포인트

EU 데이터 상주지

이 페이지의 예제에서는 기본 URL로 https://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": []
                }
            }
        ]
    }

이 내용이 도움이 되었나요?