Перейти к основному содержанию
GET
/
listings
/
availability
Bulk availability check
curl --request GET \
  --url https://csboard.com/v1/listings/availability \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "available": {
      "itm_8841201": 1,
      "itm_8841340": 3
    },
    "unavailable_ids": [
      "itm_8841999"
    ]
  }
}
Перед оформлением пакетного заказа убедитесь, что листинги, которые вы планируете купить, ещё доступны. Передайте до 100 id листингов в параметре ids через запятую; в ответе будет указано, сколько копий каждого id сейчас доступно и какие id уже недоступны. Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_....

​
Query-параметры

​
ids
string
обязательно
ID листингов через запятую, например itm_8841201,itm_8841340. Обязательно. Максимум 100 id за запрос.

​
Поля ответа

​
data
object
обязательно

​
Пример запроса

curl "https://csboard.com/v1/listings/availability?ids=itm_8841201,itm_8841340,itm_8841999" \
  -H "Authorization: Bearer csb_pub_..."

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

{
  "data": {
    "available": {
      "itm_8841201": 1,
      "itm_8841340": 3
    },
    "unavailable_ids": ["itm_8841999"]
  }
}

​
Коды ошибок

HTTP-статусКодЗначение
401missing_api_key / invalid_api_keyОтсутствует или некорректный API-ключ.
422invalid_requestНе передан ids или указано более 100 id.
429rate_limit_exceededСлишком много запросов. Подождите время, указанное в заголовке Retry-After.
Доступность — это снимок на момент запроса. ID, отмеченный как доступный, всё ещё может закончиться до момента выполнения покупки — всегда передавайте max_price_usd и обрабатывайте item_unavailable при вызове покупки.

Авторизации

​
Authorization
string
header
обязательно

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.

Параметры запроса

​
ids
string
обязательно

Comma-separated listing ids. Required. Maximum 100 ids per request.

Ответ

Availability map for the requested ids.

​
data
object
обязательно