Aliexpress SDK Rust

This repository contains a Rust implementation of the Aliexpress SDK. The SDK is designed to handle the complexities of signing requests, managing API parameters, and processing responses. It provides a convenient way to interact with the Aliexpress Open Platform API that require HMAC-SHA256 signing for secure communication.

Features

• HMAC-SHA256 Signature Generation: Automatically generates signatures for API requests using the provided secret key.
• Request Management: Facilitates the creation and management of API requests, including adding parameters and handling file uploads.
• Response Parsing: Processes API responses and provides structured access to the data.
• Asynchronous HTTP Requests: Utilizes asynchronous requests to interact with the API, ensuring non-blocking operations.

Installation

Add the following to your Cargo.toml to include this SDK in your Rust project:

[dependencies]
aliexpress_sdk = "1.0.0"

Usage

Creating a Client

Start by creating an IopClient with the server URL, app_key, and app_secret:

use aliexpress_sdk::IopClient;

let client = IopClient::new("https://api.example.com", "your_app_key", "your_app_secret");

Creating a Request

Create an IopRequest by specifying the API method you wish to call. You can add parameters and configure the request format:

use aliexpress_sdk::IopRequest;

let mut request = IopRequest::new("getProductDetails", "POST");
request.add_api_param("product_id", "12345");
request.set_format("json");

Executing the Request

Execute the request asynchronously using the IopClient:

use tokio::runtime::Runtime;

let runtime = Runtime::new().unwrap();
let response = runtime.block_on(client.execute(&request, None));

match response {
    Ok(resp) => println!("Response: {:?}", resp.body()),
    Err(err) => eprintln!("Error: {}", err),
}

Handling the Response

The SDK returns an IopResponse that contains details of the API response. You can access various fields such as the response code, message, and body:

println!("Code: {:?}", response.code());
println!("Message: {:?}", response.message());
println!("Body: {:?}", response.body());

Example: Signing a Request

The SDK includes a function for generating HMAC-SHA256 signatures required by the API:

use aliexpress_sdk::sign;
use std::collections::HashMap;

let secret = "your_secret_key";
let api = "/api/getProductDetails";
let mut parameters = HashMap::new();
parameters.insert("product_id".to_string(), "12345".to_string());

let signature = sign(secret, api, &parameters);
println!("Generated Signature: {}", signature);

License

This project is licensed under the MIT License. See the LICENSE file for details.