API cs.skins

GET/health

Проверка живости сервиса. Отвечает без обращения к базе.

curl -s https://cs-skins.ru/health
{ "ok": true, "service": "cs-skins-api" }

GET/api/v1/public/rates

Курсы валют, по которым считаются котировки. Коэффициенты означают «сколько рублей в одной единице валюты», база — рубль.

{
  "base": "RUB",
  "updatedAt": "2026-09-29T00:00:00.000Z",
  "demo": true,
  "rates": { "RUB": 1, "USD": 92.5, "EUR": 100.2, "USDT": 92.8 }
}

GET/api/v1/public/items

Каталог: список позиций с ценой витрины, ценой Steam, скидкой, float и признаком доступности. По умолчанию возвращаются все позиции каталога, включая те, что сейчас недоступны к покупке, — наличие проверяйте по полю eligible или фильтром onlyEligible=1.

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

Пример

curl -s "https://cs-skins.ru/api/v1/public/items?category=rifle,knife&floatMax=0.2&sort=price_asc&onlyEligible=1"

Ответ

{
  "currency": "RUB",
  "total": 12,
  "eligibleTotal": 9,
  "items": [ /* массив позиций, описание полей — ниже */ ]
}

Неизвестное значение фильтра трактуется как «фильтр не задан», а не как «ничего не найдено»: опечатка в параметре не должна отдавать пустой каталог. Счётчики для панели фильтров отдаёт /api/v1/public/facets — он принимает те же параметры и возвращает, сколько позиций найдёт каждый пункт при текущем отборе.

GET/api/v1/public/facets

Числа для панели фильтров: сколько позиций останется, если выбрать то или иное значение. Параметры те же, что у списка позиций.

GET/api/v1/public/purchases

Лента состоявшихся покупок для витрины: предмет, цена и время. Необязательный параметр limit (1–24, по умолчанию 10). Данные обезличены — ни идентификатора покупателя, ни трейд-ссылки, ни источника закупки в ответе нет.

curl -s "https://cs-skins.ru/api/v1/public/purchases?limit=10"

GET/api/v1/public/items/{id}

Одна позиция с полной котировкой — то, из чего собирается страница предмета. Идентификатор (id) короткий и читаемый, и берётся он из ответа каталога выше: подставлять сюда чужой пример нельзя, состав витрины меняется вместе с рынком. Человеческий адрес страницы — /item/{id}.

curl -s "https://cs-skins.ru/api/v1/public/items/{id}"

Поля позиции

Чего в ответе нет и не будет. Цена закупки и площадка, на которой мы берём предмет, наружу не отдаются: это внутренняя экономика сервиса. Ответ содержит только то, что видит покупатель на витрине.

GET/api/v1/me

Кто я для сервера и сколько у меня на балансе.

{
  "userId": "demo-user",
  "steamId": "76561198000000000",
  "nick": "unwrong",
  "avatar": "https://avatars.akamai.steamstatic.com/…_full.jpg",
  "avatarSmall": "https://avatars.akamai.steamstatic.com/…_medium.jpg",
  "profileUrl": "https://steamcommunity.com/profiles/76561198000000000",
  "role": "user",
  "balance": { "minor": 3000000, "formatted": "30 000,00 ₽", "availableMinor": 2950000 }
}

availableMinor — сумма, доступная к трате прямо сейчас: из minor уже вычтены зарезервированные под активные заказы деньги. Планировать покупки нужно по ней.

POST/api/v1/orders

Оформить покупку. Цена фиксируется в этот момент: сервер проверяет, что выгода покупателя и потолок закупки сходятся, резервирует деньги на балансе и отправляет закупку площадке с доставкой по вашей трейд-ссылке.

Тело запроса

curl -s -X POST https://cs-skins.ru/api/v1/orders \
  -H "authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -H "idempotency-key: 6f1c1f6e-0001" \
  -d '{"itemId":"glock-water-elemental-mw","tradeUrl":"https://steamcommunity.com/tradeoffer/new/?partner=1389104827&token=4ypRGYag"}'

Ответ

{
  "id": "9f0f1c1a-…",
  "number": "CS-9F0F1C1A",
  "marketHashName": "Glock-18 | Water Elemental (Minimal Wear)",
  "state": "delivered",
  "price": { "minor": 120000, "formatted": "1 200,00 ₽" },
  "createdAt": "2026-10-01T12:00:00.000Z",
  "updatedAt": "2026-10-01T12:00:04.000Z",
  "needsReview": false,
  "reason": null,
  "rejectReasons": []
}

Статусы заказа

needsReview: true означает, что покупка прошла, но закрыть заказ автоматически нельзя — им занимается человек. Деньги покупателя в этом случае не освобождаются, пока вопрос не решён.

GET/api/v1/orders

Мои заказы, новые сверху. Формат тот же, что у ответа на оформление.

GET/api/v1/orders/{id}

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

POST/api/v1/auth/logout

Завершить текущую сессию: cookie снимается, запись сессии удаляется на сервере.

GET/api/v1/support/status

Доступен ли ИИ-консультант и на какой модели он работает.

{ "available": true, "model": "deepseek/deepseek-v4.1-flash", "detail": null, "checkedAt": "…" }

POST/api/v1/support/chat

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

curl -s -X POST https://cs-skins.ru/api/v1/support/chat \
  -H "content-type: application/json" \
  -d '{"message":"Сколько идёт доставка?","history":[]}'

{ "available": true, "answer": "…", "model": "deepseek/deepseek-v4.1-flash" }