A/B 테스트

HTTP API는 서버 환경에서만 사용할 수 있습니다.

HTTP API를 사용하여 사용자에 대한 A/B 테스트 분배 결과를 확인할 수 있습니다.

SDK 키를 통해 인증을 진행합니다.

• SDK 키를 아래와 같이 HTTP 헤더에 추가해주세요.

• SDK 키는 핵클 대시보드 내 SDK 연동 정보에서 확인하실 수 있습니다.

X-HACKLE-API-KEY: {YOUR_SERVER_SDK_KEY}

Request

POST https://api.hackle.io/v1/variation

Request Body

Field	Type	Required	Description
experimentKey	number	O	분배 대상 A/B 테스트 실험키
user	User object	O	분배 대상 사용자

User Object

Field	Type	Required	Description
userId	string	X	사용자 ID (핵클 통합식별자 사용 가능)
deviceId	string	X	디바이스 ID (핵클 통합 식별자 사용가능)
identifiers	object	X	사용자 정의 식별자 key(string)-value(string) Pair
properties	object	X	사용자 속성 key(string)-value(string

Example

curl -i -X POST \
  'https://api.hackle.io/v1/variation' \
  -H 'X-HACKLE-API-KEY: YOUR_SDK_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "experimentKey": 42,
    "user": {
      "userId": "19285035",
      "deviceId": "ae2182e0",
      "identifiers": {
        "sessionId": "16930492542",
        "myCustomId": "ff01eae2"
      },
      "properties": {
        "grade": "GOLD",
        "age": 30,
        "isLogin": true
      }
    }
  }'

Response

200 OK

성공적인 요청인 경우 200 응답과 분배 결과를 반환합니다.

Response Body

Field	Type	Description
variation	string	분배그룹 (A, B, C, D, ...)
reason	string	분배사유
parameters	object	분배그룹에 설정된 파라미터

Example

{
  "variation": "B",
  "reason": "TRAFFIC_ALLOCATED",
  "parameters": {
    "buttonText": "Purchase",
    "buttonSize": 16
  }
}

400 Bad Request

유효하지 않은 요청 정보인 경우 400 상태를 반환합니다.

401 Unauthorized

X-HACKLE-API-KEY 헤더값이 없거나 유효하지 않은 SDK 키인 경우 401 상태를 반환합니다