40 releases
0.1.0-rc.41 | Sep 9, 2022 |
---|---|
0.1.0-rc.39 | Jul 11, 2022 |
0.1.0-rc.31 | Mar 24, 2022 |
#1976 in Web programming
115 downloads per month
620KB
12K
SLoC
oxide-api
A fully generated, opinionated API client library for Oxide.
API Details
API for interacting with the Oxide control plane
Contact
url | |
---|---|
https://oxide.computer | api@oxide.computer |
Client Details
This client is generated from the Oxide OpenAPI
specs based on API spec version 0.0.1
. This way it will remain
up to date as features are added. The documentation for the crate is generated
along with the code to make this library easy to use.
To install the library, add the following to your Cargo.toml
file.
[dependencies]
oxide-api = "0.1.0-rc.41"
Basic example
Typical use will require intializing a Client
. This requires
a user agent string and set of credentials.
use oxide_api::Client;
let oxide = Client::new(
String::from("api-key"),
String::from("host"),
);
Alternatively, the library can search for most of the variables required for the client in the environment:
OXIDE_TOKEN
OXIDE_HOST
And then you can create a client from the environment.
use oxide_api::Client;
let oxide = Client::new_from_env();
Dependencies
~15–29MB
~440K SLoC