Реализованы endpoint из документации BP IEK
This commit is contained in:
commit
6d5a19c3b0
4
.gitignore
vendored
Normal file
4
.gitignore
vendored
Normal file
|
@ -0,0 +1,4 @@
|
||||||
|
.venv/
|
||||||
|
__pycache__/
|
||||||
|
.env
|
||||||
|
main.py
|
1
bpiek/__init__.py
Normal file
1
bpiek/__init__.py
Normal file
|
@ -0,0 +1 @@
|
||||||
|
from .api import (BPIekApi, AUTH_URL, API_URL)
|
125
bpiek/api.py
Normal file
125
bpiek/api.py
Normal file
|
@ -0,0 +1,125 @@
|
||||||
|
|
||||||
|
import requests
|
||||||
|
from bpiek import models
|
||||||
|
|
||||||
|
AUTH_URL = "https://bp.iek.ru/oauth/login"
|
||||||
|
API_URL = "https://bp.iek.ru/api/catalog/v1/"
|
||||||
|
|
||||||
|
class BPIekApi:
|
||||||
|
def __init__(self, username, password) -> None:
|
||||||
|
self.session = requests.Session()
|
||||||
|
self.username = username
|
||||||
|
self.password = password
|
||||||
|
|
||||||
|
self._login()
|
||||||
|
|
||||||
|
def _login(self) -> None:
|
||||||
|
auth = self.session.post(
|
||||||
|
url=f"{AUTH_URL}",
|
||||||
|
headers={
|
||||||
|
"Content-Type": "application/x-www-form-urlencoded"
|
||||||
|
},
|
||||||
|
data={
|
||||||
|
"username": self.username,
|
||||||
|
"password": self.password
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
def _instance(self, endpoint, params: dict = {}):
|
||||||
|
response = self.session.get(
|
||||||
|
url=API_URL + endpoint,
|
||||||
|
headers={
|
||||||
|
"Content-Type": "application/json"
|
||||||
|
},
|
||||||
|
params={
|
||||||
|
"format": "json",
|
||||||
|
**params
|
||||||
|
}
|
||||||
|
)
|
||||||
|
return response.json()
|
||||||
|
|
||||||
|
def get_parent_categories(self) -> list[models.Category] | models.Error:
|
||||||
|
response = self._instance("client/catalog")
|
||||||
|
|
||||||
|
try:
|
||||||
|
result: models.ParentCategoriesResponse = (
|
||||||
|
models
|
||||||
|
.ParentCategoriesResponse
|
||||||
|
.model_validate(response)
|
||||||
|
)
|
||||||
|
|
||||||
|
return result.categories
|
||||||
|
|
||||||
|
except Exception as e:
|
||||||
|
return models.Error(code=400, message=str(e))
|
||||||
|
|
||||||
|
def get_product_by_article(self, article: str) -> models.Product | models.Error:
|
||||||
|
response = self._instance(f"client/products/{article}")
|
||||||
|
|
||||||
|
try:
|
||||||
|
result: models.Product = (
|
||||||
|
models
|
||||||
|
.Product
|
||||||
|
.model_validate(response)
|
||||||
|
)
|
||||||
|
|
||||||
|
return result
|
||||||
|
|
||||||
|
except Exception as e:
|
||||||
|
return models.Error(code=400, message=str(e))
|
||||||
|
|
||||||
|
def get_categories_and_products_by_slug_parent_category(self, slug) -> models.CategoriesAndProductsBySlugParentCategory | models.Error:
|
||||||
|
response = self._instance(f"client/category/{slug}/json")
|
||||||
|
|
||||||
|
try:
|
||||||
|
result: models.CategoriesAndProductsBySlugParentCategory = (
|
||||||
|
models
|
||||||
|
.CategoriesAndProductsBySlugParentCategory
|
||||||
|
.model_validate(response)
|
||||||
|
)
|
||||||
|
|
||||||
|
return result
|
||||||
|
|
||||||
|
except Exception as e:
|
||||||
|
return models.Error(code=400, message=str(e))
|
||||||
|
|
||||||
|
def get_new_products(
|
||||||
|
self,
|
||||||
|
sortBy: str = "article",
|
||||||
|
sortOrder: str = "asc",
|
||||||
|
pageSize: int = 10,
|
||||||
|
page: int = 1
|
||||||
|
) -> models.NewProductsResponse | models.Error:
|
||||||
|
response = self._instance("new-products", {
|
||||||
|
sortBy: sortBy,
|
||||||
|
sortOrder: sortOrder,
|
||||||
|
pageSize: pageSize,
|
||||||
|
page: page
|
||||||
|
})
|
||||||
|
|
||||||
|
try:
|
||||||
|
result: models.NewProductsResponse = (
|
||||||
|
models
|
||||||
|
.NewProductsResponse
|
||||||
|
.model_validate(response)
|
||||||
|
)
|
||||||
|
|
||||||
|
return result
|
||||||
|
|
||||||
|
except Exception as e:
|
||||||
|
return models.Error(code=400, message=str(e))
|
||||||
|
|
||||||
|
def get_remains_and_planresidues(self, slug) -> models.RemainsAndPlanresiduesResponse | models.Error:
|
||||||
|
response = self._instance(f"client/category/{slug}/balances-json")
|
||||||
|
|
||||||
|
try:
|
||||||
|
result: models.RemainsAndPlanresiduesResponse = (
|
||||||
|
models
|
||||||
|
.RemainsAndPlanresiduesResponse
|
||||||
|
.model_validate(response)
|
||||||
|
)
|
||||||
|
|
||||||
|
return result
|
||||||
|
|
||||||
|
except Exception as e:
|
||||||
|
return models.Error(code=400, message=str(e))
|
192
bpiek/models.py
Normal file
192
bpiek/models.py
Normal file
|
@ -0,0 +1,192 @@
|
||||||
|
from typing import Any
|
||||||
|
from pydantic import BaseModel, ConfigDict, Field
|
||||||
|
from pydantic.types import UUID1
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
class Category(BaseModel):
|
||||||
|
slug: str # Слаг категории
|
||||||
|
name: str # Название категории
|
||||||
|
url: str # Относительный адрес категории
|
||||||
|
apiUrl: str # Ссылка на скачивание файла с содержимым категории
|
||||||
|
|
||||||
|
class ProductShort(BaseModel):
|
||||||
|
class WarehouseData(BaseModel):
|
||||||
|
class Incoming(BaseModel):
|
||||||
|
dateBegan: str | None
|
||||||
|
dateEnd: str | None
|
||||||
|
amount: int
|
||||||
|
type: str # Enum: "production" "shipping" Тип поступления, production - поступление после производства, shipping - доставка на склад
|
||||||
|
|
||||||
|
warehouseId: UUID1
|
||||||
|
warehouseName: str
|
||||||
|
availableAmount: int
|
||||||
|
incoming: list[Incoming]
|
||||||
|
|
||||||
|
|
||||||
|
article: str # Артикул товара
|
||||||
|
name: str # Полное наименование товара
|
||||||
|
multiplicity: int | None # Кратность продажи
|
||||||
|
priceBase: float | None # Базовая цена с НДС
|
||||||
|
priceRrc: float | None # Рекомендованная розничная цена (РРЦ) с НДС
|
||||||
|
available: int | None # Значение остатка
|
||||||
|
units: str | None # Единицы измерения
|
||||||
|
warehouseData: list[WarehouseData]
|
||||||
|
|
||||||
|
class Product(ProductShort):
|
||||||
|
class ImageVariant(BaseModel):
|
||||||
|
url: str # Ссылка
|
||||||
|
ext: str # Расширение
|
||||||
|
width: int # Ширина
|
||||||
|
|
||||||
|
|
||||||
|
class Etim(BaseModel):
|
||||||
|
class EtimClass(BaseModel):
|
||||||
|
id: str
|
||||||
|
name: str # Название класса
|
||||||
|
|
||||||
|
class EtimFeatures(BaseModel):
|
||||||
|
id: str
|
||||||
|
name: str # Название свойства
|
||||||
|
sort: int | None # Порядок сортировки по умолчанию
|
||||||
|
unit: str | None # Единицы измерения
|
||||||
|
value: str # Значение свойства
|
||||||
|
value_union: str # Код значения
|
||||||
|
|
||||||
|
etim_class: EtimClass = Field(alias="class")
|
||||||
|
features: list[EtimFeatures]
|
||||||
|
|
||||||
|
|
||||||
|
class Complects(BaseModel):
|
||||||
|
article: str # Артикул
|
||||||
|
name: str # Наименование
|
||||||
|
quantity: int # Количество
|
||||||
|
|
||||||
|
class LeftPeriod(BaseModel):
|
||||||
|
name: str # Название характеристики
|
||||||
|
value: str # Значение характеристики
|
||||||
|
|
||||||
|
class LeftPeriodRaw(BaseModel):
|
||||||
|
class Lifespan(BaseModel):
|
||||||
|
limit: str | None
|
||||||
|
value: str | None
|
||||||
|
units: str | None
|
||||||
|
|
||||||
|
class Warranty(BaseModel):
|
||||||
|
value: str | None
|
||||||
|
units: str | None
|
||||||
|
|
||||||
|
lifespan: Lifespan
|
||||||
|
warranty: Warranty
|
||||||
|
|
||||||
|
class LogisticParams(BaseModel):
|
||||||
|
class Value(BaseModel):
|
||||||
|
group: str | None
|
||||||
|
individual: str | None
|
||||||
|
transport: str | None
|
||||||
|
|
||||||
|
name: str
|
||||||
|
nameOrig: str
|
||||||
|
value: Value
|
||||||
|
|
||||||
|
class LogisticParamsData(BaseModel):
|
||||||
|
class SinglePackage(BaseModel):
|
||||||
|
multiplicity: int | None
|
||||||
|
unit: str | None
|
||||||
|
|
||||||
|
singlePackage: SinglePackage
|
||||||
|
|
||||||
|
class DesignFeatures(BaseModel):
|
||||||
|
imageUrl: str
|
||||||
|
description: str
|
||||||
|
|
||||||
|
class Videos(BaseModel):
|
||||||
|
|
||||||
|
name: str
|
||||||
|
description: str
|
||||||
|
url: str
|
||||||
|
type: str # Enum: "url" "file"
|
||||||
|
|
||||||
|
class Software(BaseModel):
|
||||||
|
name: str
|
||||||
|
description: str
|
||||||
|
url: str
|
||||||
|
size: str
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
shortName: str # Краткое название
|
||||||
|
description: str | None # Описание
|
||||||
|
categoryName: str | None # Название категории
|
||||||
|
category: str # Относительный путь до категории в каталоге
|
||||||
|
slug: str # Слаг товара
|
||||||
|
tm: str # Торговая марка
|
||||||
|
url: str # Ссылка на товар
|
||||||
|
isArchived: bool # Архивный или нет
|
||||||
|
imageUrl: str # Фото товара (основное)
|
||||||
|
imageUrls: list[str] # Все фото товара
|
||||||
|
imageVariants: list[ImageVariant] # Все вариации изображений
|
||||||
|
advantages: str | None # Преимущества
|
||||||
|
etim: Etim # EIM характеристики товара
|
||||||
|
complects: list[Complects] # Комплектация и сопутствующие товары
|
||||||
|
complectations: str | None # Комплектация
|
||||||
|
files: list[Any] # Список файлов, относящихся к товару (ГЧ, КД, CAD-модели и т.д.)
|
||||||
|
leftPeriod: list[LeftPeriod] | None # Характеристики срока службы
|
||||||
|
leftPeriodRaw: LeftPeriodRaw # Гарантийные показатели
|
||||||
|
logisticParams: list[LogisticParams] # Логистические характеристики
|
||||||
|
logisticParamsData: LogisticParamsData | None # Подробные логистические характеристики
|
||||||
|
novelty: bool # Новинка или нет
|
||||||
|
designFeatures: list[DesignFeatures] # Отличительные особенности
|
||||||
|
videos: list[Videos] # Видео по товару
|
||||||
|
software: list[Software] # ПО по товару
|
||||||
|
banner: str | None # Текст баннера
|
||||||
|
lastModified: str | None # Дата последнего изменения
|
||||||
|
countryOfProduction: str | None # Страна производства
|
||||||
|
firstSaleDate: str | None # Дата начала продаж
|
||||||
|
feacn: str | None # Код ТН ВЭД
|
||||||
|
family: str | Any | None
|
||||||
|
series: str | Any | None
|
||||||
|
indPacking: list[str] # Ссылки на фото упаковки
|
||||||
|
analogs: list["Product"] # Аналоги
|
||||||
|
related: list["Product"] # Совместно применяемые изделия
|
||||||
|
qrCode: str | None = Field(default=None)
|
||||||
|
isOutOfAssortment: bool
|
||||||
|
isOutOfProduction: bool
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
class ParentCategoriesResponse(BaseModel):
|
||||||
|
categories: list[Category]
|
||||||
|
|
||||||
|
class CategoriesAndProductsBySlugParentCategory(BaseModel):
|
||||||
|
date: str
|
||||||
|
slug: str
|
||||||
|
name: str
|
||||||
|
url: str
|
||||||
|
categories: list[Category]
|
||||||
|
products: list[Product]
|
||||||
|
|
||||||
|
class NewProductsResponse(BaseModel):
|
||||||
|
class Data(BaseModel):
|
||||||
|
products: list[Product]
|
||||||
|
|
||||||
|
class Meta(BaseModel):
|
||||||
|
page: str
|
||||||
|
totalPages: int
|
||||||
|
totalCount: int
|
||||||
|
pageSize: int
|
||||||
|
|
||||||
|
data: Data
|
||||||
|
_meta: Meta
|
||||||
|
|
||||||
|
class RemainsAndPlanresiduesResponse(BaseModel):
|
||||||
|
date: str
|
||||||
|
products: list[ProductShort]
|
||||||
|
|
||||||
|
|
||||||
|
class Error(BaseModel):
|
||||||
|
code: int
|
||||||
|
message: str
|
21
pyproject.toml
Normal file
21
pyproject.toml
Normal file
|
@ -0,0 +1,21 @@
|
||||||
|
[tool.poetry]
|
||||||
|
name = "iek-python"
|
||||||
|
version = "0.1.0"
|
||||||
|
description = ""
|
||||||
|
authors = ["Pavel Sinitsin <spavelit@list.ru>"]
|
||||||
|
readme = "README.md"
|
||||||
|
|
||||||
|
[tool.poetry.dependencies]
|
||||||
|
python = "^3.12"
|
||||||
|
requests = "^2.32.3"
|
||||||
|
loguru = "^0.7.2"
|
||||||
|
pydantic = "^2.7.4"
|
||||||
|
|
||||||
|
|
||||||
|
[build-system]
|
||||||
|
requires = ["poetry-core"]
|
||||||
|
build-backend = "poetry.core.masonry.api"
|
||||||
|
|
||||||
|
[tool.pyright]
|
||||||
|
venvPath = "."
|
||||||
|
venv = ".venv"
|
0
tests/__init__.py
Normal file
0
tests/__init__.py
Normal file
Loading…
Reference in New Issue
Block a user