amagi 0.1.1

Rust SDK, CLI, and Web API service skeleton for multi-platform social web adapters.
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

//! Public Xiaohongshu request builders migrated from the TypeScript platform layer.

use crate::error::AppError;

use super::super::fetcher::requests::{XiaohongshuApiEndpoints, XiaohongshuRequestBuilder};
use super::types::{
    XiaohongshuCommentsOptions, XiaohongshuHomeFeedOptions, XiaohongshuNoteDetailOptions,
    XiaohongshuRequestSpec, XiaohongshuSearchNotesOptions, XiaohongshuUserNotesOptions,
    XiaohongshuUserProfileOptions,
};

/// Public Xiaohongshu API URL builder.
#[derive(Debug, Clone, PartialEq, Eq)]
#[doc(alias = "xiaohongshuApiUrls")]
pub struct XiaohongshuApiUrls {
    endpoints: XiaohongshuApiEndpoints,
}

impl Default for XiaohongshuApiUrls {
    fn default() -> Self {
        Self::new()
    }
}

impl XiaohongshuApiUrls {
    /// Create a Xiaohongshu API builder with the default upstream endpoints.
    pub fn new() -> Self {
        Self {
            endpoints: XiaohongshuApiEndpoints::default(),
        }
    }

    /// Create a Xiaohongshu API builder with explicit upstream endpoints.
    pub fn with_base_urls(
        api_base_url: impl Into<String>,
        web_base_url: impl Into<String>,
    ) -> Self {
        Self {
            endpoints: XiaohongshuApiEndpoints {
                api_base_url: api_base_url.into(),
                web_base_url: web_base_url.into(),
            },
        }
    }

    /// Build the Xiaohongshu home-feed request.
    #[doc(alias = "homeFeed")]
    pub fn home_feed(
        &self,
        options: &XiaohongshuHomeFeedOptions,
    ) -> Result<XiaohongshuRequestSpec, AppError> {
        self.request_builder().home_feed(options)
    }

    /// Build the Xiaohongshu note-detail request.
    #[doc(alias = "noteDetail")]
    pub fn note_detail(
        &self,
        options: &XiaohongshuNoteDetailOptions,
    ) -> Result<XiaohongshuRequestSpec, AppError> {
        self.request_builder().note_detail(options)
    }

    /// Build the Xiaohongshu note-comments request.
    #[doc(alias = "noteComments")]
    pub fn note_comments(
        &self,
        options: &XiaohongshuCommentsOptions,
    ) -> Result<XiaohongshuRequestSpec, AppError> {
        self.request_builder().note_comments(options)
    }

    /// Build the Xiaohongshu user-profile page request.
    #[doc(alias = "userProfile")]
    pub fn user_profile(
        &self,
        options: &XiaohongshuUserProfileOptions,
    ) -> Result<XiaohongshuRequestSpec, AppError> {
        self.request_builder().user_profile(options)
    }

    /// Build the Xiaohongshu user-note-list request.
    #[doc(alias = "userNoteList")]
    pub fn user_note_list(
        &self,
        options: &XiaohongshuUserNotesOptions,
    ) -> Result<XiaohongshuRequestSpec, AppError> {
        self.request_builder().user_note_list(options)
    }

    /// Build the Xiaohongshu emoji-list request.
    #[doc(alias = "emojiList")]
    pub fn emoji_list(&self) -> Result<XiaohongshuRequestSpec, AppError> {
        self.request_builder().emoji_list()
    }

    /// Build the Xiaohongshu note-search request.
    #[doc(alias = "searchNotes")]
    pub fn search_notes(
        &self,
        options: &XiaohongshuSearchNotesOptions,
    ) -> Result<XiaohongshuRequestSpec, AppError> {
        self.request_builder().search_notes(options, None)
    }

    fn request_builder(&self) -> XiaohongshuRequestBuilder {
        XiaohongshuRequestBuilder::new(self.endpoints.clone())
    }
}

/// Create a public Xiaohongshu API builder.
#[doc(alias = "createXiaohongshuApiUrls")]
pub fn create_xiaohongshu_api_urls() -> XiaohongshuApiUrls {
    XiaohongshuApiUrls::new()
}