Эндпоинт проверки игрока

Проверка игрока определяет игровой аккаунт до того, как пойдут деньги. Она подтверждает, что идентификатор существует для этого товара, возвращает игровое имя, чтобы покупатель мог его сверить, и показывает регион — так заказ в чужой регион отклоняется заранее, а не проваливается после оплаты.

Какие поля отправлять

Тело запроса — фиксированная пара плюс то, что требует сама игра. Сначала прочитайте GET /catalog/category/:categoryId/requirements, затем отправьте каждое возвращённое field_name вместе с sub_category_id и player_id. Поля типа single_select или multi_select принимают только значение из собственного списка select_options. Отсутствующее поле отклоняется с MISSING_REQUIRED_FIELD, а значение, нарушающее правила поля, — с INVALID_PARAMETER_FORMAT, INVALID_PARAMETER_VALUE или INVALID_PARAMETER_LENGTH; в обоих случаях details.field называет поле.

Успешный ответ возвращает игровое имя и регион, стоящие за идентификатором. Сравните этот регион с товаром, который собираетесь продать: несовпадение отклоняется с REGION_MISMATCH, и поймать его на этапе проверки стоит одного запроса, а на этапе заказа — целого цикла возврата.

POST

/player/validate

Проверка игрока

Проверяет ID игрока в конкретной игре. Передай в запросе динамические поля, которые вернул эндпоинт «Требования категории».

Лимит запросовДневная квота проверок игроков на твой аккаунт. Заголовков X-RateLimit нет.

Примечание: Какие поля нужны для каждой игры, смотри в эндпоинте «Требования категории». Все обязательные поля передавай в теле запроса. PLAYER_NOT_FOUND значит, что игра подтвердила: такого ID нет. PLAYER_CHECK_UNAVAILABLE (HTTP 503, можно повторить) говорит о том, что проверить ID сейчас не получилось, но он не отклонён.

Тело запроса

Название	Тип	Обязательный	Описание	Пример
sub_category_id	number	Да	ID подкатегории товара. Найти его можно в Catalog Explorer.	999
player_id	string	Да	Игровой ID игрока.	123456789
...requirements	varies	Нет	Дополнительные поля из эндпоинта «Требования категории». Передай каждый field_name как ключ, а значением укажи то, что ввёл пользователь.	"server": "Asia"

Запрос

curl -s -X POST "https://shop2topup.com/api/endpoints/v1/player/validate" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "sub_category_id": 999,
  "player_id": 123456789
}'

Пример ответа

{
  "success": true,
  "player": {
    "player_id": "123456789",
    "player_name": "ProGamer99",
    "region": "Asia"
  }
}

Отправьте настоящий запрос прямо с этой страницы

Вставьте API-ключ, чтобы вызвать эти эндпоинты вживую. Ключ остаётся в этой вкладке браузера и отправляется только самому API.

Enter your API key to use the interactive playground. Get your API key

Выберите эндпоинт

sub_category_id *

Use Catalog Explorer to find this

No requirements for this category.

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

Впервые на платформе? Начните с обзора API пополнения игр для реселлеров, а затем прочитайте обзор реселлерской программы SHOP2TOPUP, чтобы понять, как устроен партнёрский аккаунт.