콘텐츠로 건너뛰기

Overview

  • Version: 2.0.0
  • Servers: https://store.xsolla.com/api
  • Contact Us by Email
  • Contact URL: https://xsolla.com/
  • Required TLS version: 1.2

Catalog API는 인게임 스토어 카탈로그를 관리하고 구매를 처리하기 위한 엔드포인트를 제공합니다. 엔드포인트를 사용하여 가상 아이템, 인게임 재화, 게임 키, 번들, 장바구니 및 결제 플로우, 아이템 속성을 구성하고 외부 소스에서 아이템을 가져올 수 있습니다.

OpenAPI 설명 다운로드
언어
서버
Mock server
https://xsolla.redocly.app/_mock/ko/api/catalog/
https://store.xsolla.com/api/
작업
작업
작업
작업
작업
작업
작업
작업
작업
작업
작업
작업
작업
작업
작업
작업
작업

웹훅 설정에 대한 정보 가져오기Server-sideAdmin

요청

스토어의 웹훅 설정에 대한 정보를 가져옵니다. 자세한 정보는 웹훅 설명서를 확인하십시오.

보안
basicAuth
경로
project_idinteger필수

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

예제: 44056
curl -i -X GET \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/ko/api/catalog/v2/project/44056/admin/webhook

응답

웹훅 설정에 대한 정보를 성공적으로 수신했습니다.

본문application/json
is_enabledboolean
예제: true
secretstring
예제: "my_secret"
urlstring
예제: "http://site.ru/webhook"
응답
application/json
{ "is_enabled": true, "secret": "my_secret", "url": "http://site.ru/webhook" }

웹훅 설정에 대한 정보 업데이트Server-sideAdmin

요청

스토어의 웹훅 설정에 대한 정보를 업데이트합니다. 자세한 정보는 웹훅 설명서를 참조하세요.

보안
basicAuth
경로
project_idinteger필수

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

예제: 44056
본문application/json필수

웹훅 설정에 대한 정보입니다.

is_enabledboolean필수

게임 서비스 웹훅이 활성화되었는지 여부입니다.

게임 서비스 웹훅의 경우, 이 API 호출에서 지정된 설정은 프로젝트 설정 > 웹훅 섹션의 관리자 페이지에서 구성한 설정보다 우선시됩니다.

예제: true
secretstring필수

게임 서비스 웹훅을 서며ㅇ하기 위한 프로젝트 비밀 키입니다.

게임 서비스의 경우 이 API 호출에서 지정된 키는 프로젝트 설정 > 웹훅 섹션의 관리자 페이지에서 생성한 키보다 우선시됩니다.

예제: "my_secret_key"
urlstring필수

게임 서비스 웹훅 수신을 위한 서버의 URL입니다. URL은 공개적으로 액세스 가능해야 하며 HTTPS 프로토콜을 사용해야 합니다(예: https://example.com). 웹훅을 테스트하는 도구에서 찾은 URL을 지정할 수도 있습니다.

게임 서비스 웹훅의 경우, 이 API 호출에서 지정된 설정은 프로젝트 설정 > 웹훅 섹션의 관리자 페이지에서 구성한 설정보다 우선시됩니다.

예제: "http://site.ru/webhook"
versioninteger

웹훅 버전입니다. 버전 '2'에서 아이템 배열에는 버전 '1'(기본값)에 없는 매개 변수 is_free, is_bonusis_bundle_content가 포함됩니다.

열거형12
예제: 1
curl -i -X PUT \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/ko/api/catalog/v2/project/44056/admin/webhook \
  -H 'Content-Type: application/json' \
  -d '{
    "is_enabled": true,
    "secret": "my_secret_key",
    "url": "http://site.ru/webhook",
    "version": 1
  }'

응답

웹훅 설정에 대한 정보를 성공적으로 업데이트했습니다.

응답
콘텐츠 없음
작업
작업

카탈로그

이 API를 사용하면 모든 종류의 판매할 수 있는 아이템 또는 특정 아이템을 가져올 수 있습니다.

작업
작업
작업