Crate kittycad 

A fully generated & opinionated API client for the KittyCAD API.

API Details

API server for Zoo

Contact

url	email
https://zoo.dev	api@zoo.dev

Client Details

This client is generated from the OpenAPI specs based on API spec version 0.1.0. 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]
kittycad = "0.4.5"

Basic example

Typical use will require intializing a Client. This requires a user agent string and set of credentials.

use kittycad::Client;

let client = Client::new(String::from("api-key"));

Alternatively, the library can search for most of the variables required for the client in the environment:

• KITTYCAD_API_TOKEN
• ZOO_API_TOKEN

And then you can create a client from the environment.

use kittycad::Client;

let client = Client::new_from_env();

Modules

api_callsrequests

API calls that have been performed by users can be queried by the API. This is helpful for debugging as well as billing.

api_tokensrequests

API tokens allow users to call the API outside of their session token that is used as a cookie in the user interface. Users can create, delete, and list their API tokens. But, of course, you need an API token to do this, so first be sure to generate one in the account UI.

appsrequests

Endpoints for third party app grant flows.

executorrequests

Endpoints that allow for code execution or creation of code execution environments.

filerequests

CAD file operations. Create, get, and list CAD file conversions. More endpoints will be added here in the future as we build out transforms, etc on CAD models.

hiddenrequests

Hidden API endpoints that should not show up in the docs.

metarequests

Meta information about the API.

mlrequests

Machine learning to generate CAD models and other things.

modelingrequests

Modeling API for updating your 3D files using the Zoo engine.

oauth2requests

Endpoints that implement OAuth 2.0 grant flows.

orgsrequests

An organization is a group of users of the Zoo API. Here, we can add users to an org and perform operations on orgs.

paymentsrequests

Operations around payments and billing.

service_accountsrequests

Service accounts allow organizations to call the API. Organization admins can create, delete, and list the service accounts for their org. Service accounts are scoped to an organization not individual users, these are better to use for automations than individual API tokens, since they won’t stop working when an individual leaves the company.

storerequests

Operations involving our swag store.

types

This module contains the generated types for the library.

unitrequests

Unit conversion operations.

usersrequests

A user is someone who uses the Zoo API. Here, we can create, delete, and list users. We can also get information about a user. Operations will only be authorized if the user is requesting information about themselves.

Structs

Clientrequests

Entrypoint for interacting with the API client.

RequestBuilderretry and requests

A request builder.