# Lightspeed API Rust Crate

This crate provides a Rust interface for the Lightspeed eCommerce (C-Series) API. It allows you to easily integrate Lightspeed's powerful e-commerce features into your Rust applications.

## Features

- Simple and intuitive API client
- Asynchronous operations using Tokio
- Comprehensive error handling
- Support for all major Lightspeed API endpoints
- Easily extensible for custom use cases

## Installation

Add this to your `Cargo.toml`:

```toml
[dependencies]
lightspeed_api = { git = "https://github.com/NickTacke/lightspeed-api-rust.git" }
```

## Quick Start

Here's a simple example to get you started:

```rust
use lightspeed_api::{LightspeedClient, AccountResource};
use std::error::Error;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let client = LightspeedClient::new("live", "your_api_key", "your_api_secret", "en");
    let account = AccountResource::new(&client);
    
    let account_info = account.get().await?;
    println!("Account info: {:?}", account_info);

    Ok(())
}
```

## Usage

### Initializing the Client

First, create an instance of `LightspeedClient` with your Lightspeed API credentials:

```rust
let client = LightspeedClient::new("live", "your_api_key", "your_api_secret", "en");
```

### Working with Resources

Each API resource (e.g., products, orders, customers) has its own struct. Here's an example using the `ProductResource`:

```rust
use lightspeed_api::{LightspeedClient, ProductResource};
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let client = LightspeedClient::new("live", "your_api_key", "your_api_secret", "en");
    let products = ProductResource::new(&client);

    // Create a new product
    let new_product = json!({
        "title": "New Product",
        "description": "This is a new product",
        "price": 19.99
    });
    let created_product = products.create(&new_product).await?;

    // Get a product
    let product = products.get("product_id").await?;

    // Update a product
    let update_data = json!({"price": 24.99});
    let updated_product = products.update("product_id", &update_data).await?;

    // Delete a product
    let deleted_response = products.delete("product_id").await?;

    Ok(())
}
```

## Available Resources

- `AccountResource`
- `ProductResource`
- `OrderResource`
- `CustomerResource`
- More coming soon!

## Error Handling

This crate uses a custom `LightspeedApiError` for API-related errors. You can catch and handle these errors in your code:

```rust
match result {
    Ok(data) => println!("Success: {:?}", data),
    Err(e) => {
        if let Some(api_error) = e.downcast_ref::<LightspeedApiError>() {
            println!("API Error: {} (Status: {})", api_error.message, api_error.status_code);
        } else {
            println!("Other error: {}", e);
        }
    }
}
```

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Disclaimer

This crate is not officially associated with or endorsed by Lightspeed. Use at your own risk.