Skip to main content

zai_rs/knowledge/
document_retrieve.rs

1use super::types::DocumentGetResponse;
2use crate::client::ZaiClient;
3
4/// Retrieve document detail by id.
5///
6/// Credentials and transport live on the [`ZaiClient`], passed to
7/// [`send_via`](Self::send_via).
8pub struct DocumentGetRequest {
9    document_id: String,
10}
11
12impl DocumentGetRequest {
13    /// Create a new request targeting the given document id.
14    pub fn new(document_id: impl Into<String>) -> Self {
15        Self {
16            document_id: document_id.into(),
17        }
18    }
19
20    /// Send via a [`ZaiClient`] and parse the typed response.
21    pub async fn send_via(&self, client: &ZaiClient) -> crate::ZaiResult<DocumentGetResponse> {
22        crate::client::validation::require_non_blank(&self.document_id, "document_id")?;
23        let route = crate::client::routes::DOCUMENTS_GET;
24        let url = client
25            .endpoints()
26            .resolve_route(route, &[&self.document_id])?;
27        client
28            .send_empty::<DocumentGetResponse>(route.method(), url)
29            .await
30    }
31}