Проверить игрока
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— проверка временно недоступна; повторите позже или пропустите проверку.
Примечание
Успешная проверка ничего не резервирует. Цена и наличие подтверждаются только при создании заказа.