onspring-api-sdk-rust 0.0.1

Rust SDK for the Onspring API
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

use reqwest::Method;

use crate::client::OnspringClient;
use crate::error::Result;
use crate::models::{CreatedWithIdResponse, FileInfo, FileResponse, SaveFileRequest};

impl OnspringClient {
  /// Gets a file's metadata information.
  pub async fn get_file_info(
    &self,
    record_id: i32,
    field_id: i32,
    file_id: i32,
  ) -> Result<FileInfo> {
    let path = format!(
      "/Files/recordId/{}/fieldId/{}/fileId/{}",
      record_id, field_id, file_id
    );
    self
      .request(Method::GET, &path, &[], Option::<&()>::None)
      .await
  }

  /// Downloads a file's content.
  pub async fn get_file(
    &self,
    record_id: i32,
    field_id: i32,
    file_id: i32,
  ) -> Result<FileResponse> {
    let path = format!(
      "/Files/recordId/{}/fieldId/{}/fileId/{}/file",
      record_id, field_id, file_id
    );
    let (_status, headers, data) = self.request_bytes(Method::GET, &path, &[]).await?;

    let content_type = headers
      .get("content-type")
      .and_then(|v| v.to_str().ok())
      .map(String::from);

    let file_name = headers
      .get("content-disposition")
      .and_then(|v| v.to_str().ok())
      .and_then(|v| {
        v.split("filename=")
          .nth(1)
          .map(|s| s.trim_matches('"').to_string())
      });

    Ok(FileResponse {
      content_type,
      file_name,
      data,
    })
  }

  /// Uploads a file attachment.
  pub async fn upload_file(&self, request: SaveFileRequest) -> Result<CreatedWithIdResponse> {
    let file_part = reqwest::multipart::Part::bytes(request.file_data)
      .file_name(request.file_name)
      .mime_str(&request.content_type)
      .map_err(|e| crate::error::OnspringError::InvalidArgument(e.to_string()))?;

    let mut form = reqwest::multipart::Form::new()
      .text("RecordId", request.record_id.to_string())
      .text("FieldId", request.field_id.to_string())
      .part("File", file_part);

    if let Some(notes) = request.notes {
      form = form.text("Notes", notes);
    }
    if let Some(date) = request.modified_date {
      form = form.text("ModifiedDate", date.to_rfc3339());
    }

    self.request_multipart("/Files", form).await
  }

  /// Deletes a file attachment.
  pub async fn delete_file(&self, record_id: i32, field_id: i32, file_id: i32) -> Result<()> {
    let path = format!(
      "/Files/recordId/{}/fieldId/{}/fileId/{}",
      record_id, field_id, file_id
    );
    self
      .request_no_content(Method::DELETE, &path, &[], Option::<&()>::None)
      .await
  }
}