Перейти к основному содержимому

Subtask 1-3: Swagger UI Documentation Access Findings

Task​

Access Swagger UI documentation (https://api.sellercenter.lamoda.ru/docs/)

Date​

2026-02-10

Key Findings​

❌ Original URL Not Accessible​

  • URL: https://api.sellercenter.lamoda.ru/docs/
  • Status: ❌ NOT ACCESSIBLE - DNS resolution failed
  • Error: Could not resolve host: api.sellercenter.lamoda.ru
  • Conclusion: This URL appears to be outdated or requires special network access

✅ Alternative Documentation Sources Discovered​

Through web search, discovered that Lamoda's API documentation is hosted on academy.lamoda.ru with THREE different API systems:

1. Lamoda Seller REST API (OpenAPI 3.0)​

Documentation Page: https://academy.lamoda.ru/articles/api/api-specification-lamoda-seller-rest/lamoda-seller-partner-api-rest/

Specification File: ✅ DOWNLOADED

  • Path: lamoda_seller_rest_api.yaml (46KB)
  • Saved to: /Users/antonnozdrin/Tools/SCRAP/marketplace-api-specs/lamoda/
  • Format: OpenAPI 3.0.0
  • Version: 1.0.0
  • Title: Lamoda Seller REST API
  • Description: External REST API for Lamoda Seller partners

Base URL:

  • Production: https://public-api-seller.lamoda.ru/api

Authentication:

  • Type: Bearer Token
  • Scheme: bearerToken: []

API Categories:

  1. FBS Return Boxes (Управление возвратными коробами)

    • GET /v2/fbs/return-boxes-anomalies - Получить список возвратных коробов с аномалиями
    • GET /v2/fbs/return-boxes - Получить список возвратных коробов
    • GET /v2/fbs/return-boxes/{id} - Получить информацию о возвратном коробе
    • GET /v2/fbs/return-boxes-summary - Получить сводную информацию по возвратным коробам
    • GET /v2/fbs/return-boxes/{id}/status-history - Получить историю статусов возвратного короба

  2. FBS Return Items (Управление возвратными товарами)

    • GET /v2/fbs/return-items - Получить список возвратных товаров
    • GET /v2/fbs/return-items/{itemId}/status-history - Получить историю статусов товара
    • GET /v2/fbs/return-items-summary - Получить количество товаров по статусам

  3. Feedback Questions (Информация о вопросах)

    • GET /v2/feedback/questions - Получить вопросы от клиентов
    • POST /v2/feedback/questions/{questionId}/answer - Записать ответ на вопрос пользователя

Total Endpoints: 10

Purpose: This API focuses specifically on FBS (Fulfillment by Seller) returns management and customer feedback.

2. Lamoda Seller JSON-RPC API (Swagger 2.0)​

Documentation Page: https://academy.lamoda.ru/articles/api/apispec2/lamoda-seller-partner-api/

Specification File: ✅ DOWNLOADED

  • Path: lamoda_seller_jsonrpc_api.yaml (96KB)
  • Saved to: /Users/antonnozdrin/Tools/SCRAP/marketplace-api-specs/lamoda/
  • Format: Swagger 2.0
  • Version: 1.1.0
  • Title: Lamoda Seller partner API
  • Description: Lamoda Seller Gateway service

Base URL:

  • Host: public-api-seller.lamoda.ru
  • Base Path: /jsonrpc
  • Full URL: https://public-api-seller.lamoda.ru/jsonrpc

Authentication:

  • Type: OAuth2
  • Method: Bearer token in Authorization header
  • Note: Requires client_id and client_secret from sales-manager

API Methods (24 total):

Авторизация (Authorization)​

  1. POST /v1/tokens.create - Авторизация (OAuth2 token creation)

Справочники (Dictionaries/References)​

  1. POST /v1/dictionaries.get - Справочник аттрибутов пользователя

Номенклатура (Products/Nomenclature)​

  1. POST /v1/nomenclatures.list - Список номенклатуры
  2. POST /v1/nomenclatures-metadata.get-axapta-categories - Получить категории Axapta
  3. POST /v1/nomenclatures-metadata.get-brands - Получить бренды
  4. POST /v1/nomenclatures.update-activation - Обновить активацию номенклатуры
  5. POST /v1/nomenclatures.set-prices - Установить цены на номенклатуру
  6. POST /v1/nomenclature.update-price - Обновить цену номенклатуры
  7. POST /v1/nomenclature.set-price - Установить цену номенклатуры
  8. POST /v1/nomenclature-images.update - Обновить изображения номенклатуры
  9. POST /v1/nomenclature.list - Список номенклатуры (альтернативный метод)
  10. POST /v1/nomenclatures.store - Сохранить номенклатуру

Атрибуты (Attributes)​

  1. POST /v1/attributes.list - Список атрибутов
  2. POST /v1/attributes.sku.list - Список атрибутов SKU
  3. POST /v1/attribute-dictionaries.list - Список справочников атрибутов
  4. POST /v1/attributes-dictionaries-mappings.get - Получить маппинги справочников атрибутов

Статусы и Категории (Statuses & Categories)​

  1. POST /v1/order-item-statuses.list - Список статусов товаров заказа
  2. POST /v1/erp-categories.list - Список категорий ERP

Склады и Остатки (Warehouses & Stock)​

  1. POST /v1/fbo/warehouse.list - Список складов FBO
  2. POST /v1/stock.list - Список остатков

Заказы (Orders)​

  1. POST /v1/order.ship - Отгрузка заказа
  2. POST /v1/order/delivery-note.download - Скачать накладную на отгрузку

Вопросы (Questions/Feedback)​

  1. POST /v1/questions.list - Список вопросов
  2. POST /v1/questions.answer - Ответ на вопрос

Total Methods: 24

Purpose: This is the main JSON-RPC API for Lamoda Seller operations covering products, prices, stock, orders, and more.

3. Previously Discovered: Lamoda B2B Platform API​

Status: ✅ Found in subtask-1-2

  • File: lamoda_b2b_openapi.yaml (252KB)
  • Format: OpenAPI 3.0.0
  • Base URLs:
    • Demo: https://api-demo-b2b.lamoda.ru
    • Live: https://api-b2b.lamoda.ru
  • Authentication: OAuth2
  • Description: Full B2B Platform API for partners

Summary of Downloaded Specifications​

API SystemFormatSizeEndpoints/MethodsFileStatus
B2B Platform APIOpenAPI 3.0252KBTBDlamoda_b2b_openapi.yaml✅ Downloaded (subtask-1-2)
Seller REST APIOpenAPI 3.046KB10 endpointslamoda_seller_rest_api.yaml✅ Downloaded (this subtask)
Seller JSON-RPC APISwagger 2.096KB24 methodslamoda_seller_jsonrpc_api.yaml✅ Downloaded (this subtask)

Total Downloaded: 3 specification files

Key Insights​

Multiple API Systems​

Lamoda has THREE distinct API systems:

  1. B2B Platform API - OAuth2, RESTful, comprehensive B2B operations
  2. Seller REST API - Bearer token, focused on FBS returns and feedback
  3. Seller JSON-RPC API - OAuth2, JSON-RPC protocol, main seller operations

Different Base Domains​

  • ❌ api.sellercenter.lamoda.ru - NOT accessible (outdated?)
  • ✅ public-api-seller.lamoda.ru - Correct domain for Seller APIs
  • ✅ api-b2b.lamoda.ru - B2B Platform API
  • ✅ academy.lamoda.ru - Documentation portal

Documentation Structure​

  • All official documentation is hosted on academy.lamoda.ru
  • Each API has a dedicated specification page with downloadable YAML files
  • Specifications follow OpenAPI/Swagger standards

Authentication Methods​

  • B2B Platform: OAuth2
  • Seller REST: Bearer token
  • Seller JSON-RPC: OAuth2 (requires client_id and client_secret)

Next Steps​

  1. ✅ Complete subtask-1-4: Access Partner Portal
  2. ✅ Complete subtask-1-5: Download additional specs (already done)
  3. Begin Phase 2: Deep Investigation of all three API systems
  4. Document all endpoints, authentication methods, rate limits
  5. Compile comprehensive Russian documentation

Files Saved​

All specification files have been saved to:

/Users/antonnozdrin/Tools/SCRAP/marketplace-api-specs/lamoda/
├── lamoda_b2b_openapi.yaml (252KB) - B2B Platform API
├── lamoda_seller_rest_api.yaml (46KB) - Seller REST API
└── lamoda_seller_jsonrpc_api.yaml (96KB) - Seller JSON-RPC API

Verification​

  • Attempted to access original Swagger UI URL
  • Discovered correct documentation sources
  • Downloaded all available OpenAPI/Swagger specifications
  • Verified specification files are valid YAML
  • Analyzed API structure and endpoints
  • Documented all findings

Status: ✅ SUBTASK COMPLETED