Перейти к содержимому

Методы API · Глава 7

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

Убедитесь, что ID игрока настоящий, до того как примете деньги от клиента. Проверка необязательна, бесплатна и не создаёт заказ.

1 мин чтения

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

POST/offers/{id}/check

Передайте те же fields, которые собираетесь отправить с заказом:

curl https://partner.goxost.net/api/v1/offers/1042/check \
  -H "Authorization: Bearer $PARTNER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "fields": { "player_id": "5123456789" } }'
{ "data": { "valid": true, "player_name": "Shadow", "reason": null, "checked": true } }
Поле Описание
valid true, если ID игрока принят.
player_name Ник игрока, если игра его возвращает, иначе null. Покажите его клиенту для подтверждения.
reason Почему ID не принят, или null.
checked false, если этот продукт нельзя проверить заранее. Тогда valid ничего не означает — заказ всё равно можно создать.

Ошибки

  • 422 VALIDATION_FAILED — обязательное поле не передано или имеет неверное значение; см. error.fields.
  • 404 NOT_FOUND — неизвестный id оффера.
  • 503 SUPPLIER_UNAVAILABLE — проверка временно недоступна; повторите позже или пропустите проверку.
Примечание

Успешная проверка ничего не резервирует. Цена и наличие подтверждаются только при создании заказа.