#odoo #json-rpc #api-bindings

odoo-api

Type-safe and full-coverage implementation of the Odoo JSON-RPC API, including ORM and Web methods. Supports sessioning, multi-database, async and blocking via reqwest, and bring-your-own requests.

10 releases

0.2.5 Feb 24, 2023
0.2.4 Jan 16, 2023
0.1.4 Dec 24, 2022

#529 in Web programming

Download history 73/week @ 2024-02-13 46/week @ 2024-02-20 5/week @ 2024-02-27

124 downloads per month

MIT/Apache

230KB
4.5K SLoC

odoo-api

github crates.io docs.rs docs.rs

odoo_api

The odoo_api crate provides a type-safe and full-coverage implementation of the Odoo JSON-RPC API, including ORM and Web methods. It supports sessioning, multi-database, async and blocking via reqwest, and bring-your-own requests.

API Methods

For a full list of supported API methods, see odoo_api::service.

Bring your own requests

By default, odoo_api uses reqwest as its HTTP implementation. It is also possible to provide your own HTTP implementation (see OdooClient for more info).

Example

To use the default reqwest implementation, add this to your Cargo.toml:

[dependencies]
odoo_api = "0.2"

Then make your requests:

use odoo_api::{OdooClient, jvec, jmap};

// build the client and authenticate
let url = "https://demo.odoo.com";
let client = OdooClient::new_reqwest_async(url)?
    .authenticate(
        "some-database",
        "admin",
        "password",
    ).await?;

// fetch a list of users
let users = client.execute(
    "res.users",
    "search",
    jvec![]
).send().await?;

// fetch the login and partner_id fields from user id=1
let info = client.execute_kw(
    "res.users",
    "read",
    jvec![[1]],
    jmap!{
        "fields": ["login", "partner_id"]
    }
).send().await?;

// fetch a list of databases
let databases = client.db_list(false).send().await?;

// fetch server version info
let version_info = client.common_version().send().await?;

Dependencies

~1–14MB
~171K SLoC