> ## Documentation Index > Fetch the complete documentation index at: https://steamgold.dev/llms.txt > Use this file to discover all available pages before exploring further. # Поиск снаряжения > Позволяет искать и фильтровать доступное снаряжение по различным критериям. ## OpenAPI ````yaml POST /gear/search openapi: 3.0.1 info: title: OpenAPI SteamGold description: Is used for steamgold API license: name: MIT version: 1.0.0 servers: - url: https://api.steamgold.dev/v1 security: - bearerAuth: [] paths: /gear/search: post: summary: Поиск снаряжения description: >- Позволяет искать и фильтровать доступное снаряжение по различным критериям. requestBody: description: Параметры для поиска и фильтрации снаряжения content: application/json: schema: $ref: '#/components/schemas/GearSearchRequest' required: true responses: '200': description: Список доступного снаряжения content: application/json: schema: $ref: '#/components/schemas/GearSearchResponse' '400': description: Неверный запрос или параметры поиска content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: GearSearchRequest: type: object properties: platform: type: integer description: >- Идентификатор приложения Steam, для которого вы хотите получить снаряжение. По умолчанию `730` (для CS2). default: 730 query: type: string description: >- Строка поиска по названию предмета. Используется для фильтрации снаряжения по названию или части названия. filters: type: object description: >- Объект, содержащий параметры фильтрации для поиска снаряжения. Все поля внутри `filters` необязательны. properties: price: type: object description: >- Фильтрация по диапазону цен. Значения `min` и `max` указываются в **центах**. properties: min: type: number description: Минимальная цена в центах. max: type: number description: Максимальная цена в центах. weapon: type: array items: type: string description: Фильтрация по типу оружия (например, AK-47, M4A4). type: type: array items: type: string description: >- Фильтрация по типу снаряжения. Возможные значения соответствуют полю `details.type` в ответе. rarity: type: array items: type: string description: >- Фильтрация по редкости предмета. Возможные значения соответствуют полю `details.rarity` в ответе. exterior: type: array items: type: string description: >- Фильтрация по внешнему износу для скинов оружия. Возможные значения соответствуют полю `details.exterior` в ответе. quality: type: array items: type: string description: >- Фильтрация по качеству предмета (например, StatTrak™, Souvenir). Возможные значения соответствуют полю `details.quality` в ответе. phase: type: array items: type: string description: Фильтрация по фазе. limit: type: integer description: >- Максимальное количество предметов для возврата на странице. По умолчанию `10`. default: 10 page: type: integer description: Номер страницы для пагинации. По умолчанию `0`. default: 0 sort: type: string description: Порядок сортировки результатов. По умолчанию `price_asc`. enum: - price_asc - price_desc GearSearchResponse: required: - status - gear - total type: object properties: status: description: Статус ответа API. type: string gear: type: array description: Массив объектов снаряжения, соответствующих критериям запроса. items: type: object properties: id: type: integer description: Уникальный идентификатор предмета. name: type: string description: Отображаемое название предмета (например, название скина). price: type: number description: Цена предмета в **копейках**. image: type: string description: URL-адрес иконки/миниатюры предмета. inspectLink: type: string nullable: true description: >- Ссылка для осмотра предмета в игре, если доступна (для скинов). description: type: string nullable: true description: Основной описательный текст предмета. details: $ref: '#/components/schemas/GearItemDetails' description: >- Этот объект содержит детализированные метаданные о предмете снаряжения. paint: type: object description: >- Этот объект содержит свойства, относящиеся к визуальному паттерну и износу предмета. properties: float: type: number nullable: true description: Значение представляющее износ предмета (от 0.0 до 1.0). seed: type: number nullable: true description: ID покраски, влияющее на вариации паттерна. index: type: number nullable: true description: Индекс покраски, для конкретных вариаций. pattern: type: number nullable: true description: >- ID паттерна для предметов с отличительными визуальными паттернами (скины, наклейки, нашивки, граффити). attachments: type: array description: >- Этот массив представляет прикрепления (наклейки, нашивки), которые могут быть *применены к предмету*. Для расходуемых прикреплений (таких как сами предметы-наклейки, нашивки или граффити) он описывает прикрепление, *содержащееся в предмете*. Массив всегда будет иметь фиксированную длину 5 элементов. Каждый элемент будет либо объектом `Attachment`, либо `null`, если слот пуст. items: $ref: '#/components/schemas/Attachment' nullable: true maxItems: 5 minItems: 5 total: type: integer description: >- Общее количество предметов, найденных по запросу (без учёта `limit` и `page`). Error: required: - code - message type: object properties: code: description: HTTP-код ответа type: integer format: int32 message: description: Сообщение об ошибке type: string GearItemDetails: type: object description: Детализированные метаданные о предмете снаряжения. properties: type: type: string description: >- Общая классификация предмета. Соответствует ключам фильтра `filters.type`. weapon: type: string nullable: true description: >- Конкретное название оружия, если предмет является скином оружия. Соответствует ключам `filters.weapon`. set: type: string nullable: true description: >- Название коллекции или кейса, к которому принадлежит предмет. Соответствует ключам `filters.item_set`. quality: type: string nullable: true description: >- Атрибут качества предмета, например, StatTrak™ или Souvenir. Соответствует ключам `filters.quality`. rarity: type: string nullable: true description: Уровень редкости предмета. Соответствует ключам `filters.rarity`. exterior: type: string nullable: true description: >- Уровень внешнего износа для скинов оружия. Соответствует ключам `filters.exterior`. phase: type: string nullable: true description: >- Фаза Доплера для определённых раскрасок ножей. Соответствует ключам `filters.phase`. tournament: type: string nullable: true description: >- Название турнира, связанного с предметом (например, для мажорных стикеров, пропусков). color: type: string nullable: true description: Конкретный цвет для предметов граффити. Attachment: type: object description: Структура объекта `Attachment` properties: id: type: integer nullable: true description: Внутренний ID наклейки/нашивки/граффити. name: type: string nullable: true description: Отображаемое название наклейки/нашивки/граффити. wear: type: number nullable: true description: Значение износа (стирания) для *применённой* наклейки. type: type: string description: Тип прикрепления. (`sticker`, `patch`, `graffiti_pattern`) image: type: string nullable: true description: URL изображения наклейки/нашивки/граффити. securitySchemes: bearerAuth: type: http scheme: bearer ````