Packages

A lightweight, stateless eBay SDK for Elixir applications.

Current section

Files

Jump to
elixir_bay README.md
Raw

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.