ztk-rust-sdk 0.1.1

折淘客 (ZheTaoKe/ZTK) Rust SDK - 多平台电商 API 客户端库
Documentation
//! 京东平台枚举类型
//!
//! 定义京东平台特有的枚举类型

use serde::{Deserialize, Serialize};
use serde_repr::{Deserialize_repr, Serialize_repr};

/// 京粉频道 ID
///
/// 京东京粉精选商品的频道分类
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize_repr, Deserialize_repr)]
#[repr(u32)]
pub enum JdEliteId {
    /// 好券商品
    GoodCoupon = 1,
    /// 精选卖场
    Selected = 2,
    /// 9.9 包邮
    NineNine = 10,
    /// 京东配送
    JdDelivery = 15,
    /// 实时热销榜
    HotSale = 22,
    /// 为你推荐
    Recommend = 23,
    /// 数码家电
    Digital = 24,
    /// 超市
    Supermarket = 25,
    /// 母婴玩具
    Baby = 26,
    /// 家具日用
    Home = 27,
    /// 美妆穿搭
    Beauty = 28,
    /// 图书文具
    Book = 30,
    /// 今日必推
    TodayMust = 31,
    /// 京东好物
    JdGood = 32,
    /// 京东秒杀
    Seckill = 33,
    /// 拼购商品
    Pingou = 34,
    /// 高收益榜
    HighProfit = 40,
    /// 自营热卖榜
    SelfHot = 41,
    /// 秒杀进行中
    SeckillNow = 108,
    /// 新品首发
    NewProduct = 109,
    /// 自营
    SelfOperated = 110,
    /// 京东爆品
    JdHot = 112,
    /// 首购商品
    FirstBuy = 125,
    /// 高佣榜单
    HighCommission = 129,
    /// 视频商品
    Video = 130,
    /// 历史最低价商品榜
    LowestPrice = 153,
}

impl Default for JdEliteId {
    fn default() -> Self {
        JdEliteId::GoodCoupon
    }
}

/// 京东排序字段
///
/// 京东商品查询的排序字段选项
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub enum JdSortField {
    /// 单价
    Price,
    /// 佣金比例
    CommissionShare,
    /// 佣金
    Commission,
    /// 30天引单量
    InOrderCount30DaysSku,
    /// 评论数
    Comments,
    /// 好评数
    GoodComments,
}

impl Default for JdSortField {
    fn default() -> Self {
        JdSortField::InOrderCount30DaysSku
    }
}

/// 转链类型 (京东)
///
/// 控制京东转链返回的链接类型
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize_repr, Deserialize_repr)]
#[repr(u8)]
pub enum JdChainType {
    /// 长链
    Long = 1,
    /// 短链
    Short = 2,
    /// 长链+短链
    Both = 3,
}

impl Default for JdChainType {
    fn default() -> Self {
        JdChainType::Short
    }
}

/// 京东订单查询类型
///
/// 控制订单查询的时间维度
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize_repr, Deserialize_repr)]
#[repr(u8)]
pub enum JdOrderQueryType {
    /// 按下单时间
    OrderTime = 1,
    /// 按完成时间
    FinishTime = 2,
    /// 按更新时间
    UpdateTime = 3,
}

impl Default for JdOrderQueryType {
    fn default() -> Self {
        JdOrderQueryType::OrderTime
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_jd_elite_id_serialize() {
        let value = JdEliteId::HotSale;
        let json = serde_json::to_string(&value).unwrap();
        assert_eq!(json, "22");
    }

    #[test]
    fn test_jd_elite_id_deserialize() {
        let value: JdEliteId = serde_json::from_str("33").unwrap();
        assert_eq!(value, JdEliteId::Seckill);
    }

    #[test]
    fn test_jd_sort_field_serialize() {
        let value = JdSortField::CommissionShare;
        let json = serde_json::to_string(&value).unwrap();
        assert_eq!(json, "\"commissionShare\"");
    }

    #[test]
    fn test_jd_sort_field_deserialize() {
        let value: JdSortField = serde_json::from_str("\"price\"").unwrap();
        assert_eq!(value, JdSortField::Price);
    }

    #[test]
    fn test_jd_chain_type_serialize() {
        let value = JdChainType::Short;
        let json = serde_json::to_string(&value).unwrap();
        assert_eq!(json, "2");
    }

    #[test]
    fn test_jd_chain_type_deserialize() {
        let value: JdChainType = serde_json::from_str("1").unwrap();
        assert_eq!(value, JdChainType::Long);
    }

    #[test]
    fn test_jd_order_query_type_serialize() {
        let value = JdOrderQueryType::UpdateTime;
        let json = serde_json::to_string(&value).unwrap();
        assert_eq!(json, "3");
    }

    #[test]
    fn test_jd_order_query_type_deserialize() {
        let value: JdOrderQueryType = serde_json::from_str("2").unwrap();
        assert_eq!(value, JdOrderQueryType::FinishTime);
    }

    #[test]
    fn test_default_values() {
        assert_eq!(JdEliteId::default(), JdEliteId::GoodCoupon);
        assert_eq!(JdSortField::default(), JdSortField::InOrderCount30DaysSku);
        assert_eq!(JdChainType::default(), JdChainType::Short);
        assert_eq!(JdOrderQueryType::default(), JdOrderQueryType::OrderTime);
    }
}