키 활성화

Xsolla Developers

또는

관리자 페이지로

키 활성화Webhook POST

사용자가 키를 활성화하면 엑솔라는 알림 메시지를 웹훅 URL로 보냅니다.

Request

Request Body schema: application/json

activation_date

string <datetime>

ISO 8601에 따라 키 활성화 날짜는 YYYYMMDDHHMMSS형식입니다.

key

string

활성화 키.

notification_type

string

알림 유형.

object

지역 제한 클러스터 설정이 있는 오브젝트. 클러스터는 제한 유형과 게임을 이용할 수 있는 국가, 서버, 로캘 목록을 포함합니다.

countries	Array of strings 클러스터의 국개 바열.
locales	Array of strings 로캘 배열.
name	string 클러스터 이름.
servers	Array of strings 게임 서버 배열.
sku	string 고유 클러스터 ID.
types	Array of strings 제한 유형 배열.

object

사용자 정의 프로젝트 설정(개체)입니다.

merchant_id	integer 판매자 ID입니다.
project_id	integer 프로젝트 ID. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.

sku

string

고유 키 패키지 ID.

user_country

string

사용자의 국가. ISO 3166-1 alpha-2 standard에 따른 2자로 된 국가 코드를 사용합니다.

user_id

string

사용자 ID.

Responses

204

성공적인 처리 표시를 반환합니다.

400

제공된 정보에 오류가 있는 경우 반환합니다(예: 필수 매개변수 누락, 인증 실패 등).

500

서버에 일시적인 오류가 있음을 표시하려면 돌아가세요.

Request samples

CURL
PHP
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'authorization: Signature 13342703ccaca5064ad33ba451d800c5e823db8f' \
-d '{
  "notification_type": "redeem_key",
  "settings": {
        "project_id": 18404,
        "merchant_id": 2340
  },
  "key": "wqdqwwddq9099022",
  "sku": "com.xsolla.key_123",
  "user_id": "sample_user",
  "activation_date": "2018-11-20T08:38:51+03:00",
  "user_country": "EN",
  "restriction": {
      "name": "cls_1",
      "types": [
          "activation"
        ],
        "countries": [
            "RU"
        ]
    }
}'

Response samples

application/json

{"error": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}