Server Bindings
The SDK currently uses auto-generated bindings for the server. The bindings are generated using the
openapi-generator
to generate the Rust bindings from the server OpenAPI specifications.
These bindings are regularly updated to ensure they stay in sync with the server.
The bindings are exposed as multiple crates, one for each backend service:
bitwarden-api-api
: For theApi
service that contains most of the server side functionality.bitwarden-api-identity
: For theIdentity
service that is used for authentication.
When performing any API calls the goal is to use the generated bindings as much as possible. This
ensures any changes to the server are accurately reflected in the SDK. The generated bindings are
stateless, and always expects to be provided a Configuration
instance. The SDK exposes these under
the get_api_configurations
function on the Client
struct. get_api_configurations
also
refreshes the authentication token if required.
// Example API call
let config: &ApiConfigurations = client.get_api_configurations().await;
let response: SyncResponseModel =
bitwarden_api_api::apis::sync_api::sync_get(&config.api, exclude_subdomains).await?;
It's highly recommended to not expose the request and response models of the generated bindings and instead use your own models. This decouples the server request / response models from the SDK models, and allows for easier changes in the future.
We recommend using either the From
or TryFrom
traits depending on if the conversion requires
error handling. Below are two examples of how this can be done:
impl TryFrom<bitwarden_api_api::models::CipherLoginUriModel> for LoginUri {
type Error = Error;
fn try_from(uri: bitwarden_api_api::models::CipherLoginUriModel) -> Result<Self> {
Ok(Self {
uri: EncString::try_from_optional(uri.uri)?,
r#match: uri.r#match.map(|m| m.into()),
uri_checksum: EncString::try_from_optional(uri.uri_checksum)?,
})
}
}
impl From<bitwarden_api_api::models::UriMatchType> for UriMatchType {
fn from(value: bitwarden_api_api::models::UriMatchType) -> Self {
match value {
bitwarden_api_api::models::UriMatchType::Domain => Self::Domain,
bitwarden_api_api::models::UriMatchType::Host => Self::Host,
bitwarden_api_api::models::UriMatchType::StartsWith => Self::StartsWith,
bitwarden_api_api::models::UriMatchType::Exact => Self::Exact,
bitwarden_api_api::models::UriMatchType::RegularExpression => Self::RegularExpression,
bitwarden_api_api::models::UriMatchType::Never => Self::Never,
}
}
}