모든 프로모션 목록 가져오기

Digital Distribution Hub API

In-Game Store & Buy Button API

개요

API 정의 다운로드

사용자 특성

관리자

개인 맞춤형 카탈로그

번들

관리자

카탈로그

장바구니 및 결제

장바구니(클라이언트 측)

장바구니(서버측)

결제(클라이언트 측)

결제(서버 측)

주문

무료 아이템

일반

웹훅

선주문

판매자

카탈로그

공통 지역

게임 키

카탈로그

권한

관리자

플레이어 인벤토리

클라이언트

관리

교차 인벤토리

프로모션

일반

가상 아이템 및 인게임 재화

관리자

카탈로그

가상 결제

NFT 아이템

관리자

카탈로그

제한 사항

관리

REWARD CHAINS & VALUE POINTS

관리자

클라이언트

Pay Station API

Publisher Account API

Subscriptions API

Webhooks

모든 프로모션 목록 가져오기

get/v2/project/{project_id}/admin/promotion

프로젝트의 프로모션 목록을 가져옵니다.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

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

Example: 44056

query Parameters

limit	integer 페이지 요소 개수 제한입니다. Example: limit=50
offset	integer 목록이 생성된 요소의 개수입니다(개수는 0부터 시작함). Example: offset=0
enabled	integer `is_enabled` 플래그로 요소를 필터링합니다.

Responses

200

프로모션 목록을 성공적으로 수신했습니다.

401

기본 인증이 전달되지 않았거나 잘못되었습니다. 기본 인증 또는 올바른 자격 증명을 사용했는지 확인해야 합니다.

Request samples

Response samples

application/json

{"promotions": [{"bonus": [{"item": {"bundle_type": "virtual_currency_package",
"content": [ ],
"description": null,
"image_url": null,
"name": {"en-US": "Diamonds pack",
"ru-RU": "Пак кристаллов"
},
"sku": "diamonds_pack",
"type": "bundle"
},
"quantity": 1
}
],
"condition": [{"item": {"description": null,
"image_url": null,
"inventory_options": {"consumable": true,
"expiration_period": null
},
"name": {"en-US": "VG name",
"ru-RU": "Название VG"
},
"sku": "virtual_good_bonus_2",
"type": "virtual_good"
}
}
],
"date_end": null,
"date_start": "2020-01-01T00:00",
"discount": null,
"id": 1,
"is_enabled": true,
"name": "promotion_1",
"type": "item_bonus"
},
{"bonus": null,
"condition": [{"item": {"description": null,
"image_url": null,
"inventory_options": {"consumable": true,
"expiration_period": null
},
"name": {"en-US": "VG name",
"ru-RU": "Название VG"
},
"sku": "virtual_good_bonus_2",
"type": "virtual_good"
}
}
],
"date_end": "2030-01-01T00:00",
"date_start": "2020-01-01T00:00",
"discount": {"percent": "10.99"
},
"id": 2,
"is_enabled": false,
"name": "promotion_2",
"type": "item_discount"
},
{"bonus": [{"item": {"description": null,
"image_url": null,
"inventory_options": {"consumable": true,
"expiration_period": null
},
"name": {"en-US": "VG name",
"ru-RU": "Название VG"
},
"sku": "virtual_good_bonus_2",
"type": "virtual_good"
},
"quantity": 2
}
],
"condition": [{"item": {"external_id": "coupon_2",
"is_enabled": true,
"name": {"en-US": "Coupon name",
"ru-RU": "Название купона"
},
"redeem_code_limit": 1,
"redeem_total_limit": null,
"redeem_user_limit": null
}
}
],
"date_end": "2030-01-01T00:00",
"date_start": "2022-01-01T00:00",
"discount": null,
"id": 3,
"is_enabled": true,
"name": "promotion_3",
"type": "coupon_bonus"
},
{"bonus": [{"item": {"description": null,
"image_url": null,
"inventory_options": {"consumable": true,
"expiration_period": null
},
"name": {"en-US": "VG name",
"ru-RU": "Название VG"
},
"sku": "virtual_good_bonus_2",
"type": "virtual_good"
},
"quantity": 2
}
],
"condition": [{"item": {"external_id": "coupon_3",
"is_enabled": true,
"name": {"en-US": "Coupon name",
"ru-RU": "Название купона"
},
"redeem_code_limit": 1,
"redeem_total_limit": null,
"redeem_user_limit": null
}
}
],
"date_end": "2031-01-01T00:00",
"date_start": "2018-01-01T00:00",
"discount": {"percent": "12.99"
},
"id": 4,
"is_enabled": false,
"name": "promotion_4",
"type": "promocode_bonus_discount"
},
{"bonus": [{"item": {"description": null,
"image_url": null,
"name": {"en-US": "VG name",
"ru-RU": "Название VG"
},
"sku": "virtual_good_bonus_4",
"type": "virtual_good"
},
"quantity": 1
}
],
"condition": null,
"date_end": null,
"date_start": "2020-01-01T00:00",
"discount": null,
"id": 5,
"is_enabled": true,
"name": "promotion_5",
"type": "cart_bonus"
}
],
"total_promotions_count": 5
}