For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.
실험 실험 API 관리 뮤텍스 그룹 엔드포인트
| 이름 | 설명 |
|---|---|
| 목록 | 해당 구성 세부 정보를 포함한 뮤텍스 그룹 목록입니다. |
| 뮤텍스 그룹 편집 | 뮤텍스 그룹을 편집합니다. |
| 뮤텍스 그룹 슬롯 편집 | 뮤텍스 그룹 슬롯을 편집합니다. |
| 생성 | 새 뮤텍스를 생성합니다. |
목록
bash
GET https://experiment.amplitude.com/api/1/mutexes
해당 구성 세부 정보를 포함한 뮤텍스 그룹 목록을 가져옵니다.
쿼리 매개 변수
| 이름 | 설명 |
|---|---|
limit | 반환될 뮤텍스 그룹의 최대 수입니다. 1000으로 제한되었습니다. |
cursor | 결과 "페이지"를 시작할 위치를 지정하는 오프셋입니다. |
응답
성공적인 요청은 200 OK 응답과 응답 본문에 JSON으로 인코딩된 뮤텍스 그룹 목록을 반환합니다.
curl --request GET \
--url 'https://experiment.amplitude.com/api/1/mutexes?limit=1000' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <management-api-key>'
자세한 정보 보기
bash
GET https://experiment.amplitude.com/api/1/mutexes/<id>
뮤텍스 그룹의 구성 세부 정보를 가져옵니다.
경로 변수
| 이름 | 설명 |
|---|---|
id | 필수입니다. 문자열입니다. 뮤텍스 그룹의 ID입니다. |
응답
성공적인 요청은 200 OK 응답과 뮤텍스 그룹의 세부 정보가 포함된 JSON 객체를 반환합니다.
curl --request GET \
--url 'https://experiment.amplitude.com/api/1/mutexes/<id>' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <management-api-key>'
뮤텍스 그룹 편집
bash
PATCH https://experiment.amplitude.com/api/1/mutexes/{id}
뮤텍스 그룹을 편집합니다.
경로 변수
| 이름 | 설명 |
|---|---|
id | 필수입니다. 문자열입니다. 뮤텍스 그룹의 ID입니다. |
요청 본문
| 이름 | 설명 |
|---|---|
name | 선택 사항입니다. 유형: string. 뮤텍스 그룹 이름입니다. |
description | 선택 사항입니다. 유형: string. 뮤텍스 그룹 설명입니다. |
archive | 선택 사항입니다. 유형: boolean. 뮤텍스 그룹을 보관하거나 보관을 해제합니다. true인 경우 Amplitude는 다른 모든 인수를 무시하고 뮤텍스 그룹을 삭제된 것으로 표시한 다음 모든 하위 실험의 상위 종속성에서 해당 그룹을 제거합니다. |
요청 예제
json
{
"name": "updated name",
"description": "updated description"
}
응답
성공적인 요청은 200 OK 응답을 반환합니다.
요청
curl
curl --request PATCH \
--url 'https://experiment.amplitude.com/api/1/mutexes/<id>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <management-api-key>' \
--data '{"name": "updated name"}'
뮤텍스 그룹 슬롯 편집
bash
PATCH https://experiment.amplitude.com/api/1/mutexes/{id}/slots/{slotIndex}
뮤텍스 그룹 슬롯을 편집합니다.
경로 변수
| 이름 | 설명 |
|---|---|
id | 필수입니다. 문자열입니다. 뮤텍스 그룹의 ID입니다. |
slotIndex | 필수입니다. 번호입니다. 이 뮤텍스의 슬롯 인덱스입니다. |
요청 본문
| 이름 | 설명 |
|---|---|
experiments | 선택 사항입니다. 유형: number array. 포함될 실험 ID 목록입니다. |
holdouts | 선택 사항입니다. 유형: number array. 포함할 홀드아웃 그룹 ID 목록입니다. |
individuals | 선택 사항입니다. 유형: string array. 포함할 사용자 ID 또는 장치 ID 목록입니다. |
요청 예제
json
{
"experiments": [123, 456],
"individuals": ["x@amplitude.com", "y@amplitude.com", "abcde-12345"]
}
응답
성공적인 요청은 200 OK 응답을 반환합니다.
요청
curl
curl --request PATCH \
--url 'https://experiment.amplitude.com/api/1/mutexes/<id>/slots/<slotIndex>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <management-api-key>' \
--data '{"experiments": [123, 456]}'
생성
bash
POST https://experiment.amplitude.com/api/1/mutexes
새 뮤텍스 그룹을 생성합니다.
요청 본문
| 이름 | 설명 |
|---|---|
projectId | 필수입니다. 유형: number. 뮤텍스 그룹의 프로젝트 ID입니다. |
name | 필수입니다. 유형: string. 뮤텍스 그룹 이름입니다. |
key | 선택 사항입니다. 유형: string. 뮤텍스 그룹 키입니다. 모든 플래그, 실험, 홀드아웃 그룹 및 뮤텍스 그룹에서 고유해야 합니다. 지정되지 않은 경우 Amplitude에서 하나를 생성합니다. |
description | 선택 사항입니다. 유형: string. 뮤텍스 그룹에 대한 설명입니다. |
evaluationMode | 선택 사항입니다. 유형: string. 뮤텍스 그룹 평가 모드입니다. 옵션은 local 또는 remote입니다. 기본값은 remote입니다. |
bucketingKey | 선택 사항입니다. 유형: string. 사용자를 버킷화할 기준으로 사용할 사용자 속성입니다. 기본값은 amplitude_id입니다. |
bucketingSalt | 선택 사항입니다. 유형: string. 뮤텍스 그룹 버케팅 솔트입니다. 기본값은 무작위화된 문자열입니다. |
slots | 필수입니다. 유형: object array. slots의 배열입니다. 최대 20개의 슬롯을 지원합니다. 순서가 중요합니다. |
슬롯
slots 필드에는 이러한 객체가 포함되어 있습니다.
| 이름 | 설명 |
|---|---|
percentage | 필수입니다. 유형: number. 이 슬롯에 대한 트래픽의 비율입니다. 1과 100 대상 구간의 정수입니다(포함). 모든 슬롯의 백분율의 합계는 100이어야 합니다. |
experiments | 선택 사항입니다. 유형: string array. 포함될 실험 ID 목록입니다. |
holdouts | 선택 사항입니다. 유형: number array. 포함할 홀드아웃 그룹 ID 목록입니다. |
individuals | 선택 사항입니다. 유형: number array. 포함할 사용자 ID 또는 장치 ID 목록입니다. |
요청 예제
json
{
"projectId":"<projectId>",
"name": "Example Mutex Group",
"key": "example-mutex",
"description": "An example mutex group",
"evaluationMode": "remote",
"slots": [
{
"percentage": 40,
"experiments": [123],
"holdouts": [456]
},
{
"percentage": 60,
"experiments": [789],
"individuals": ["x@amplitude.com"]
}
]
}
응답
성공적인 요청은 200 OK 응답 및 뮤텍 그룹의 ID와 URL이 포함된 JSON 객체를 반환합니다.
curl --request POST \
--url 'https://experiment.amplitude.com/api/1/mutexes' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <management-api-key>' \
--data '{"projectId":"<projectId>","slots":[{"percentage":40},{"percentage":60}]}'
이 내용이 도움이 되었나요?