Избранное

Управление избранными тендерами: получение списка, добавление и удаление.

Список избранного

GET /favorites

Возвращает список тендеров в избранном с пагинацией.

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

Параметр Тип Обязательный Описание
page integer Нет Номер страницы (по умолчанию: 1)
page_size integer Нет Количество на странице (по умолчанию: 20)

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

JSON 200 OK 
{
  "tenders": [
    {
      "id": 12345,
      "tender_id": "0373100066918000152",
      "name": "Закупка оборудования",
      "price": 1000000,
      "publish_date": "2024-01-15T10:00:00",
      "end_date": "2024-01-25T18:00:00",
      "region_name": "Москва",
      "platform_name": "ЕИС",
      "status_name": "Подача заявок",
      "favorited_at": "2024-01-20T15:30:00"
    }
  ],
  "total": 25,
  "page": 1,
  "page_size": 20,
  "pages": 2
}

Поля ответа

Поле Тип Описание
tenders array Массив избранных тендеров
total integer Общее количество
page integer Текущая страница
pages integer Общее количество страниц

Добавление в избранное

POST /favorites/{tender_id}

Добавляет тендер в избранное текущего пользователя.

Параметры пути

Параметр Тип Описание
tender_id string ID тендера (etp_id)

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

cURL 
curl -X POST "https://zakupki.fraim.ru/api/v2/favorites/0373100066918000152" \
  -H "X-API-Token: your_api_token_here"

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

JSON 200 OK 
{
  "success": true,
  "is_favorite": true,
  "message": "Тендер добавлен в избранное"
}

Удаление из избранного

DELETE /favorites/{tender_id}

Удаляет тендер из избранного.

Параметры пути

Параметр Тип Описание
tender_id string ID тендера (etp_id)

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

cURL 
curl -X DELETE "https://zakupki.fraim.ru/api/v2/favorites/0373100066918000152" \
  -H "X-API-Token: your_api_token_here"

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

JSON 200 OK 
{
  "success": true,
  "is_favorite": false,
  "message": "Тендер удален из избранного"
}

Избранное с обновлениями

GET /favorites/updates

Возвращает избранные тендеры, в которых были изменения с момента добавления в избранное (update_date > favorited_at).

Отслеживание изменений

Этот endpoint позволяет отслеживать изменения в избранных тендерах: сроки, цены, статусы, документы. Если тендер обновился после того, как вы добавили его в избранное — он появится в этом списке.

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

Параметр Тип Обязательный Описание
page integer Нет Номер страницы (по умолчанию: 1)
page_size integer Нет Количество на странице (по умолчанию: 20)

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

cURL 
curl -X GET "https://zakupki.fraim.ru/api/v2/favorites/updates?page=1&page_size=20" \
  -H "X-API-Token: your_api_token_here"

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

JSON 200 OK 
{
  "total": 3,
  "page": 1,
  "page_size": 20,
  "pages": 1,
  "new_tenders_count": 3,
  "remaining_balance": 995,
  "items": [
    {
      "id": 12345,
      "etp_id": "0373100066918000152",
      "name": "Закупка оборудования",
      "price": 1000000,
      "publish_date": "2024-01-15T10:00:00",
      "end_date": "2024-01-25T18:00:00",
      "update_date": "2024-01-20T14:30:00",
      "region": {
        "id": 77,
        "name": "Москва"
      },
      "platform": {
        "id": 1,
        "name": "ЕИС"
      },
      "status": {
        "id": 1,
        "name": "Подача заявок"
      },
      "is_new": true
    }
  ]
}

Сценарий использования

  1. Добавьте интересные тендеры в избранное
  2. Раз в день запрашивайте GET /favorites/updates
  3. Получите только те тендеры, которые обновились с момента добавления
  4. Запросите детали обновлённых тендеров для просмотра конкретных изменений