실험 실험 API 관리 뮤텍스 그룹 엔드포인트

이름	설명
뮤텍스 그룹 나열	뮤텍스 그룹을 해당 구성 세부 정보와 함께 나열합니다.
뮤텍스 그룹 세부 정보 가져오기	단일 뮤텍스 그룹의 구성 세부 정보를 가져옵니다.
뮤텍스 그룹 편집	뮤텍스 그룹의 이름, 설명 또는 아카이브 상태를 업데이트합니다.
뮤텍스 그룹 슬롯 편집	뮤텍스 그룹 슬롯의 내용을 업데이트합니다.
뮤텍스 그룹 생성	새 뮤텍스 그룹을 생성합니다.

EU 데이터 상주지

이 페이지의 예제에서는 기본 URL https://experiment.amplitude.com을(를) 사용합니다. 프로젝트에서 Amplitude의 EU 데이터 센터를 사용하고 있다면 대신 https://experiment.eu.amplitude.com을(를) 사용하십시오. 자세한 내용은 지역을 참조하십시오.

뮤텍스 그룹 나열

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`	문자열	아니요	뮤텍스 그룹 이름입니다.
`description`	문자열	아니요	뮤텍스 그룹 설명입니다.
`archive`	부울입니다.	아니요	뮤텍스 그룹을 보관하거나 보관을 해제합니다. `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`	숫자 배열	아니요	포함할 실험 ID 목록입니다.
`holdouts`	숫자 배열	아니요	포함할 홀드아웃 그룹 ID 목록입니다.
`individuals`	문자열 배열	아니요	포함할 사용자 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`	숫자	예	뮤텍스 그룹의 프로젝트 ID입니다.
`name`	문자열	예	뮤텍스 그룹 이름입니다.
`key`	문자열	아니요	뮤텍스 그룹 키입니다. 모든 플래그, 실험, 홀드아웃 그룹 및 뮤텍스 그룹에서 고유해야 합니다. 사용자가 키를 지정하지 않을 경우 Amplitude는 키를 생성합니다.
`description`	문자열	아니요	뮤텍스 그룹에 대한 설명입니다.
`evaluationMode`	문자열	아니요	뮤텍스 그룹 평가 모드입니다. 옵션은 `local` 또는 `remote`입니다. 기본값은 `remote`입니다.
`bucketingKey`	문자열	아니요	사용자를 버킷화할 기준으로 사용할 사용자 속성입니다. 기본값은 `amplitude_id`입니다.
`bucketingSalt`	문자열	아니요	뮤텍스 그룹 버케팅 솔트입니다. 기본값은 무작위화된 문자열입니다.
`slots`	객체 배열	예	`slots`의 배열입니다. 최대 20개의 슬롯을 지원합니다. 순서가 중요합니다.

슬롯

slots필드에는 이러한 객체가 포함되어 있습니다.

이름	유형	필수	설명
`percentage`	숫자	예	이 슬롯에 대한 트래픽의 비율입니다. 1과 100 대상 구간의 정수(포함). 모든 슬롯의 백분율의 합계는 100이어야 합니다.
`experiments`	문자열 배열	아니요	포함할 실험 ID 목록입니다.
`holdouts`	숫자 배열	아니요	포함할 홀드아웃 그룹 ID 목록입니다.
`individuals`	숫자 배열	아니요	포함할 사용자 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"]
    }
  ]
}

응답

성공적인 요청은 뮤텍스 그룹의 ID 및 URL이 포함된 200 OK 응답과 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}]}'

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