asterisk-rs-ari 0.7.2

Async Rust client for the Asterisk REST Interface (ARI)
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

//! device state operations.

use crate::client::{url_encode, AriClient};
use crate::error::Result;

/// ari device state representation
#[derive(Debug, Clone, serde::Deserialize)]
pub struct DeviceState {
    pub name: String,
    pub state: String,
}

/// list all device states
pub async fn list(client: &AriClient) -> Result<Vec<DeviceState>> {
    client.get("/deviceStates").await
}

/// get a specific device state
pub async fn get(client: &AriClient, name: &str) -> Result<DeviceState> {
    client
        .get(&format!("/deviceStates/{}", url_encode(name)))
        .await
}

/// update a device state
///
/// note: asterisk ari spec uses PUT for this endpoint, but asterisk
/// also accepts POST for compatibility
pub async fn update(client: &AriClient, name: &str, state: &str) -> Result<()> {
    client
        .post_empty(&format!(
            "/deviceStates/{}?deviceState={}",
            url_encode(name),
            url_encode(state)
        ))
        .await
}

/// delete a device state
pub async fn delete(client: &AriClient, name: &str) -> Result<()> {
    client
        .delete(&format!("/deviceStates/{}", url_encode(name)))
        .await
}