route

A route is the rate-limit identity of a call. Built by glyde/rest/seg; the constructors here are internal. Both seg.resolve and seg.from_path walk the same segment rules, so two spellings of one endpoint cannot land in two buckets.

Types

Route

opaque </>

Opaque because class is derived from template. A record update could move one and leave the other, and a route that wrongly claims to be an interaction callback skips the global limit.

pub opaque type Route

Sublimit

</>

Discord’s undocumented per-resource sublimits. Invisible in the headers: a 429 with a large retry_after on a bucket that still claims capacity.

pub type Sublimit {
  NoSublimit
  Named(String)
  Aged(created_at_ms: Int)
}

Constructors

```
NoSublimit
```
```
Named(String)
```
A named subset of an endpoint: “name-or-topic” on PATCH /channels/{id} is 2 per 10 minutes.
```
Aged(created_at_ms: Int)
```
Deleting a message older than two weeks lands in a different bucket (discord-api-docs#1295). The limiter has the clock, so it resolves this.

WebhookToken

opaque </>

A live credential that is also half a major parameter. A closure, not a field, because echo and string.inspect read straight through an opaque record. Reaching the bucket key is the one thing it still has to do, so key and major_key return the token in plain text and everything else does not.

pub opaque type WebhookToken

Values

channel_placeholder

</>

pub const channel_placeholder: String

compose_key

</>

pub fn compose_key(left: String, major: String) -> String

Every bucket key is a left half (the provisional route_key, or Discord’s hash once known) and the major half. One joiner, so they cannot drift.

guild_placeholder

</>

pub const guild_placeholder: String

id_placeholder

</>

pub const id_placeholder: String

Any id that is not a major parameter. Discord buckets these together, so they need no name of their own.

key

</>

pub fn key(route: Route, now_ms now_ms: Int) -> String

The provisional bucket key, until x-ratelimit-bucket names the real one. Holds the webhook token on a webhook route, so keep it out of logs.

major_key

</>

pub fn major_key(route: Route) -> String

The major half of the key, to pair with Discord’s x-ratelimit-bucket hash. Holds the webhook token on a webhook route, so keep it out of logs.

method

</>

pub fn method(route: Route) -> http.Method

opaque_placeholder

</>

pub const opaque_placeholder: String

Text that is neither an id nor a literal: an interaction token, an invite code.

reaction_placeholder

</>

pub const reaction_placeholder: String

A reaction emoji and everything after it.

route_key

</>

pub fn route_key(route: Route, now_ms now_ms: Int) -> String

The route half of the key. Discord reports one hash per route and the real bucket is that hash paired with the major parameter, so both halves exist.

sublimit

</>

pub fn sublimit(route: Route) -> Sublimit

template

</>

pub fn template(route: Route) -> String

The unsubstituted template, e.g. “/channels/{channel.id}/messages”.

unbound

</>

pub fn unbound(route: Route) -> Bool

Exempt from the global limit and in no bucket. True for interaction callbacks and nothing else.

webhook_placeholder

</>

pub const webhook_placeholder: String

webhook_token_placeholder

</>

pub const webhook_token_placeholder: String

Half of a webhook’s major parameter, which has no business in a template.

with_sublimit

</>

pub fn with_sublimit(route: Route, sublimit: Sublimit) -> Route

The one part of a route a caller may change: a path cannot know how old the message it deletes is.