antistock-api 0.1.0

Python wrapper for the Antistock Developer API.

antistock-api

A typed Python wrapper for the Antistock Developer API.

Covers all 88 endpoints across 17 resource groups (orders, products, customers, charges, coupons, FAQs, fraud rules, telegram broadcasts/users, tickets, warehouses, and more).

Install

pip install antistock-api

Requires Python 3.11+.

Quick start

from antistock_api import AntistockClient, OrderStatus

with AntistockClient('your-jwt-token') as client:
    me = client.user.get_current()

    for order in client.orders.iter_all(
        shop_id = 'shop-uuid',
        status_filter = OrderStatus.COMPLETED,
        page_size = 100,
    ):
        print(order)

    client.products.create(
        shop_id = 'shop-uuid',
        body = {'name': 'New product', 'price': 10},
    )

Features

• Full coverage — every endpoint in the OpenAPI spec, organized by resource (client.orders, client.products, client.warehouses, etc.)
• Typed — full from __future__ import annotations type hints, py.typed marker, enums for every spec enum
• Pagination — every list endpoint has a paired iter_all(...) generator that walks all pages
• Auth — bearer token (string) or callable TokenProvider for dynamic refresh
• Errors — typed exception hierarchy (AntistockAuthenticationError, AntistockNotFoundError, AntistockRateLimitError, etc.)
• Retries — exponential backoff on 429 and 5xx, honors Retry-After
• Context manager — with AntistockClient(...) as client: for clean session shutdown

Auth

from antistock_api import AntistockClient

client = AntistockClient('your-jwt-token')

def get_token() -> str:
    return load_token_from_secrets_manager()

client = AntistockClient(get_token)

Configuration

from antistock_api import AntistockClient

client = AntistockClient(
    'your-jwt-token',
    base_url = 'https://business-api.antistock.io',
    timeout_seconds = 30.0,
    max_retries = 3,
    retry_backoff_seconds = 0.5,
)

Errors

from antistock_api import (
    AntistockClient,
    AntistockNotFoundError,
    AntistockRateLimitError,
)

try:
    client.orders.get('shop-uuid', 'missing-id')

except AntistockNotFoundError as E:
    print('order not found:', E.errors)

except AntistockRateLimitError as E:
    print('rate limited, retry after', E.retry_after_seconds)

License

MIT