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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
use crate::client::NoBody;
use crate::client::scope::{Scoped, Webhooks};
use crate::{Error, Page, types::*, util::urlish};
impl<S: Webhooks> Scoped<'_, S> {
/// POST `{scope}/webhooks`, subscribe an HTTPS endpoint to events (e.g.
/// `message.received`). The response carries the signing `secret` exactly
/// once; store it. Inbox and pod scopes ignore `inbox_ids`/`pod_ids` (the
/// scope already targets the delivery); set those only at [`Client::org`](crate::Client::org).
pub async fn create_webhook(&self, webhook: CreateWebhook) -> Result<Webhook, Error> {
self.client
.request(
reqwest::Method::POST,
&format!("{}/webhooks", self.base()),
&[],
Some(&webhook),
)
.await
}
/// GET `{scope}/webhooks`, one page.
pub async fn list_webhooks(&self, page: Page) -> Result<WebhookList, Error> {
self.client
.request(
reqwest::Method::GET,
&format!("{}/webhooks", self.base()),
&page.query(),
None::<&NoBody>,
)
.await
}
/// Every webhook, draining pagination.
pub async fn list_all_webhooks(&self) -> Result<Vec<Webhook>, Error> {
let mut out = Vec::new();
let mut token = None;
loop {
let resp = self
.list_webhooks(Page {
limit: None,
page_token: token,
})
.await?;
let next = resp.next_page_token;
out.extend(resp.webhooks);
match next {
Some(t) => token = Some(t),
None => return Ok(out),
}
}
}
/// GET `{scope}/webhooks/{webhook_id}`.
pub async fn get_webhook(&self, webhook_id: &str) -> Result<Webhook, Error> {
self.client
.request(
reqwest::Method::GET,
&format!("{}/webhooks/{}", self.base(), urlish(webhook_id)),
&[],
None::<&NoBody>,
)
.await
}
/// PATCH `{scope}/webhooks/{webhook_id}`, edit event types and inbox/pod
/// targeting (see [`UpdateWebhook`]).
pub async fn update_webhook(
&self,
webhook_id: &str,
update: UpdateWebhook,
) -> Result<Webhook, Error> {
self.client
.request(
reqwest::Method::PATCH,
&format!("{}/webhooks/{}", self.base(), urlish(webhook_id)),
&[],
Some(&update),
)
.await
}
/// DELETE `{scope}/webhooks/{webhook_id}`.
pub async fn delete_webhook(&self, webhook_id: &str) -> Result<(), Error> {
self.client
.request(
reqwest::Method::DELETE,
&format!("{}/webhooks/{}", self.base(), urlish(webhook_id)),
&[],
None::<&NoBody>,
)
.await
}
}