hermes-sdk 0.1.0

The most comprehensive Rust SDK for eBay marketplace APIs - 17 specialized clients with 86+ methods
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

use crate::config::EbayConfig;
use crate::error::{HermesError, HermesResult};
use crate::ebay::auth::EbayAuth;
use std::sync::Arc;

// Import eBay Commerce Catalog SDK models and APIs
use hermes_ebay_commerce_catalog::models::{Product, ProductSearchResponse};
use hermes_ebay_commerce_catalog::apis::configuration::Configuration as CatalogConfiguration;

/// eBay Commerce Catalog API client for product catalog operations
pub struct CatalogClient {
    config: EbayConfig,
    auth: Arc<EbayAuth>,
}

impl CatalogClient {
    /// Create a new Catalog API client
    pub fn new(config: EbayConfig) -> HermesResult<Self> {
        let auth = Arc::new(EbayAuth::new(config.clone())?);
        Ok(Self { config, auth })
    }

    /// Get product information by ePID (eBay Product ID)
    pub async fn get_product(
        &self,
        epid: &str,
        marketplace_id: Option<&str>,
    ) -> HermesResult<Product> {
        let start_time = std::time::Instant::now();
        
        // Get access token
        let token_start = std::time::Instant::now();
        let token = self.auth.get_access_token().await?;
        let token_duration = token_start.elapsed();
        tracing::info!("OAuth token request for get_product: {:?}", token_duration);
        
        // Set up configuration
        let mut config = CatalogConfiguration::new();
        config.base_path = if self.config.sandbox {
            "https://api.sandbox.ebay.com/commerce/catalog/v1".to_string()
        } else {
            "https://api.ebay.com/commerce/catalog/v1".to_string()
        };
        config.oauth_access_token = Some(token);
        
        // Call the eBay SDK
        let ebay_start = std::time::Instant::now();
        let result = hermes_ebay_commerce_catalog::apis::product_api::get_product(
            &config,
            epid,
            marketplace_id,
        ).await;
        let ebay_duration = ebay_start.elapsed();
        tracing::info!("eBay get_product API call: {:?}", ebay_duration);
        
        match result {
            Ok(response) => {
                let total_duration = start_time.elapsed();
                let our_processing = total_duration - token_duration - ebay_duration;
                tracing::info!("get_product total: {:?} | Our processing: {:?}", total_duration, our_processing);
                Ok(response)
            },
            Err(e) => {
                let total_duration = start_time.elapsed();
                tracing::error!("eBay get_product error after {:?}: {:?}", total_duration, e);
                Err(HermesError::ApiRequest(format!("eBay get_product failed: {:?}", e)))
            }
        }
    }

    /// Search the product catalog
    pub async fn search_catalog(
        &self,
        marketplace_id: Option<&str>,
        aspect_filter: Option<&str>,
        category_ids: Option<&str>,
        fieldgroups: Option<&str>,
        gtin: Option<&str>,
        limit: Option<&str>,
        mpn: Option<&str>,
        offset: Option<&str>,
        query: Option<&str>,
    ) -> HermesResult<ProductSearchResponse> {
        let start_time = std::time::Instant::now();
        
        // Get access token
        let token_start = std::time::Instant::now();
        let token = self.auth.get_access_token().await?;
        let token_duration = token_start.elapsed();
        tracing::info!("OAuth token request for search_catalog: {:?}", token_duration);
        
        // Set up configuration
        let mut config = CatalogConfiguration::new();
        config.base_path = if self.config.sandbox {
            "https://api.sandbox.ebay.com/commerce/catalog/v1".to_string()
        } else {
            "https://api.ebay.com/commerce/catalog/v1".to_string()
        };
        config.oauth_access_token = Some(token);
        
        // Call the eBay SDK
        let ebay_start = std::time::Instant::now();
        let result = hermes_ebay_commerce_catalog::apis::product_summary_api::search(
            &config,
            marketplace_id,
            aspect_filter,
            category_ids,
            fieldgroups,
            gtin,
            limit,
            mpn,
            offset,
            query,
        ).await;
        let ebay_duration = ebay_start.elapsed();
        tracing::info!("eBay search_catalog API call: {:?}", ebay_duration);
        
        match result {
            Ok(response) => {
                let total_duration = start_time.elapsed();
                let our_processing = total_duration - token_duration - ebay_duration;
                tracing::info!("search_catalog total: {:?} | Our processing: {:?}", total_duration, our_processing);
                Ok(response)
            },
            Err(e) => {
                let total_duration = start_time.elapsed();
                tracing::error!("eBay search_catalog error after {:?}: {:?}", total_duration, e);
                Err(HermesError::ApiRequest(format!("eBay search_catalog failed: {:?}", e)))
            }
        }
    }
}