Інтеграція інтернет-магазину з AliExpress (API)

Інтеграція інтернет-магазину з AliExpress (API)

AliExpress надає API для продавців через платформу AliExpress Open Platform. Інтеграція дозволяє управляти товарами, цінами, рівнями запасів та замовленнями на глобальному маркетплейсі.

Аутентифікація через TOP Protocol

import hashlib
import hmac
import time

class AliexpressClient:
    def __init__(self, app_key: str, app_secret: str, access_token: str):
        self.app_key      = app_key
        self.app_secret   = app_secret
        self.access_token = access_token

    def _sign(self, params: dict) -> str:
        sorted_params = sorted(params.items())
        sign_string   = self.app_secret
        for k, v in sorted_params:
            sign_string += f"{k}{v}"
        sign_string += self.app_secret
        return hashlib.md5(sign_string.encode()).hexdigest().upper()

    def call(self, method: str, params: dict) -> dict:
        base_params = {
            'method':       method,
            'app_key':      self.app_key,
            'timestamp':    str(int(time.time() * 1000)),
            'format':       'json',
            'v':            '2.0',
            'session':      self.access_token,
            **params
        }
        base_params['sign'] = self._sign(base_params)

        resp = requests.post('https://api.taobao.com/router/rest', data=base_params)
        return resp.json()

Публікація товару

def publish_product(self, product: dict) -> str:
    result = self.call('aliexpress.solution.product.schema.get', {
        'subject':     product['name'],
        'local_price': product['price'],
        'currency_code': 'USD',
    })
    return result.get('result', {}).get('product_id')

Синхронізація запасів

def update_inventory(self, product_id: str, sku_list: list) -> None:
    self.call('aliexpress.ds.add.info', {
        'product_id':     product_id,
        'sku_stock_info': json.dumps([{
            'skuAttr':  sku['attributes'],
            'quantity': sku['stock'],
            'price':    sku['price'],
        } for sku in sku_list]),
    })

Отримання замовлень

def get_orders(self, start_time: str, end_time: str) -> list:
    result = self.call('aliexpress.trade.ds.order.get', {
        'create_time_start': start_time,
        'create_time_end':   end_time,
        'page_size':         50,
    })
    return result.get('result', {}).get('order_list', {}).get('order_dto', [])

Особливості AliExpress API

• Потребує реєстрацію як продавець AliExpress
• Контент для EU потребує дотримання вимог Product Safety Regulation
• API працює через єдиний endpoint (api.taobao.com) для всіх операцій з методом у параметрі
• Всі суми в USD для глобального маркетплейсу

Терміни

Реєстрація в AliExpress Open Platform: 1–2 тижні. Інтеграція: 14–20 робочих днів.