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

use axum::{
    Json,
    extract::{Path, Query, State},
    http::HeaderMap,
};

use super::super::support::{FetchResult, fetch_error_response, xiaohongshu_fetcher};
use super::types::{XiaohongshuHomeFeedQuery, XiaohongshuNoteCommentsQuery, XiaohongshuNoteQuery};
use crate::platforms::xiaohongshu::{
    XiaohongshuCommentsOptions, XiaohongshuEmojiList, XiaohongshuHomeFeed,
    XiaohongshuHomeFeedOptions, XiaohongshuNoteComments, XiaohongshuNoteDetail,
    XiaohongshuNoteDetailOptions,
};
use crate::server::state::AppState;

/// Fetch the Xiaohongshu home feed through the web API.
pub async fn xiaohongshu_home_feed(
    Query(query): Query<XiaohongshuHomeFeedQuery>,
    headers: HeaderMap,
    State(state): State<AppState>,
) -> FetchResult<XiaohongshuHomeFeed> {
    xiaohongshu_fetcher(&state, &headers)
        .fetch_home_feed(&XiaohongshuHomeFeedOptions {
            cursor_score: query.cursor_score,
            num: query.num,
            refresh_type: query.refresh_type,
            note_index: query.note_index,
            category: query.category,
            search_key: query.search_key,
        })
        .await
        .map(Json)
        .map_err(fetch_error_response)
}

/// Fetch one Xiaohongshu note detail through the web API.
pub async fn xiaohongshu_note_detail(
    Path(note_id): Path<String>,
    Query(query): Query<XiaohongshuNoteQuery>,
    headers: HeaderMap,
    State(state): State<AppState>,
) -> FetchResult<XiaohongshuNoteDetail> {
    xiaohongshu_fetcher(&state, &headers)
        .fetch_note_detail(&XiaohongshuNoteDetailOptions {
            note_id,
            xsec_token: query.xsec_token,
        })
        .await
        .map(Json)
        .map_err(fetch_error_response)
}

/// Fetch one page of Xiaohongshu note comments through the web API.
pub async fn xiaohongshu_note_comments(
    Path(note_id): Path<String>,
    Query(query): Query<XiaohongshuNoteCommentsQuery>,
    headers: HeaderMap,
    State(state): State<AppState>,
) -> FetchResult<XiaohongshuNoteComments> {
    xiaohongshu_fetcher(&state, &headers)
        .fetch_note_comments(&XiaohongshuCommentsOptions {
            note_id,
            cursor: query.cursor,
            xsec_token: query.xsec_token,
        })
        .await
        .map(Json)
        .map_err(fetch_error_response)
}

/// Fetch the Xiaohongshu emoji catalog through the web API.
pub async fn xiaohongshu_emoji_list(
    headers: HeaderMap,
    State(state): State<AppState>,
) -> FetchResult<XiaohongshuEmojiList> {
    xiaohongshu_fetcher(&state, &headers)
        .fetch_emoji_list()
        .await
        .map(Json)
        .map_err(fetch_error_response)
}