Current section
Files
Jump to
Current section
Files
elixir_bay
README.md
README.md
# ElixirBay
A lightweight, stateless eBay SDK for Elixir applications.
This package provides an idiomatic starting point for interacting with eBay APIs without persisting tokens or account state. Applications remain responsible for storing OAuth tokens and managing business logic.
## Features
- OAuth authorization URL generation
- OAuth token exchange and refresh helpers
- Typed structs for browse, inventory, and orders data
- Normalized error values
- Basic pagination support
## Example
```elixir
client = Ebay.Client.new(client_id: "...", client_secret: "...", redirect_uri: "https://example.com/callback")
{:ok, token} = Ebay.Auth.exchange_code(client, "auth-code")
client = Ebay.Client.with_token(client, token.access_token)
{:ok, orders} = Ebay.Orders.list(client)
```
## Design Notes
- The SDK is intentionally stateless and does not persist tokens or user state.
- Applications own token storage, account associations, and background jobs.
- The core API surface includes client construction, OAuth helpers, browse/inventory/orders modules, and normalized errors.