kintone 0.5.4

kintone REST API client
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

# kintone-rs

[![Crates.io](https://img.shields.io/crates/v/kintone.svg)](https://crates.io/crates/kintone)
[![Documentation](https://docs.rs/kintone/badge.svg)](https://docs.rs/kintone)

**DISCLAIMER**: this OSS is my own personal work and does not have any relationship with Cybozu Inc. or any other organization which I belong to.

**WARNING**: This library is under development and is likely to undergo incompatible changes in the future.

A client library of Kintone REST APIs for Rust.

## Quick Start

```rust
use kintone::client::{Auth, KintoneClient};

// Create a client
let client = KintoneClient::new(
    "https://your-domain.cybozu.com",
    Auth::api_token("your-api-token")
);

// Get a record
let response = kintone::v1::record::get_record(app_id, record_id)
    .send(&client)?;

// Print the record
for (field_code, field_value) in response.record.fields() {
    println!("{}: {:?}", field_code, field_value);
}
```

For detailed documentation, installation instructions, and usage examples, please refer to the [API documentation](https://docs.rs/kintone).

## Middleware Support

kintone-rs supports a middleware system for handling cross-cutting concerns like retries, logging, and authentication. Middleware layers can be easily composed to add functionality to your Kintone client.

### Available Middleware

- **RetryLayer**: Automatically retries failed requests with exponential backoff
- **LoggingLayer**: Logs HTTP request and response information for debugging
- **BasicAuthLayer**: Adds HTTP Basic authentication headers for proxy/reverse proxy access

### Example: Retry

```rust
use std::time::Duration;
use kintone::client::{Auth, KintoneClientBuilder};
use kintone::middleware;

let client = KintoneClientBuilder::new(
        "https://your-domain.cybozu.com",
        Auth::api_token("your-api-token")
    )
    .layer(middleware::RetryLayer::new(
        5,                              // max_attempts
        Duration::from_millis(500),     // initial_delay
        Duration::from_secs(30),        // max_delay
        None                            // use default retry logic (retries any errors)
    ))
    .build();
```

## Examples

You can find runnable examples in the `examples` directory.

The examples require environment variables to be set:

```bash
export KINTONE_BASE_URL=https://your-domain.cybozu.com
export KINTONE_API_TOKEN=your-api-token
cargo run --example get_record
```