#discord-api #discord #twilight


Discord API models for the Twilight ecosystem

91 releases

0.16.0-rc.1 Feb 21, 2024
0.15.4 Sep 10, 2023
0.15.2 Apr 27, 2023
0.15.1 Feb 26, 2023
0.2.4 Nov 29, 2020

#2 in #discord-api

Download history 2620/week @ 2024-02-15 4961/week @ 2024-02-22 6863/week @ 2024-02-29 7204/week @ 2024-03-07 8521/week @ 2024-03-14 3230/week @ 2024-03-21 20638/week @ 2024-03-28 4319/week @ 2024-04-04 5584/week @ 2024-04-11 5678/week @ 2024-04-18 5638/week @ 2024-04-25 4080/week @ 2024-05-02 3350/week @ 2024-05-09 11464/week @ 2024-05-16 11146/week @ 2024-05-23 3939/week @ 2024-05-30

30,590 downloads per month
Used in 35 crates (32 directly)

ISC license

30K SLoC


codecov badge discord badge github badge license badge rust badge

See the twilight documentation for more information.

twilight-model is a crate of serde models defining the Discord APIs with few convenience methods on top of them.

These are in a single crate for ease of use, a single point of definition, and a sort of versioning of the Discord API. Similar to how a database schema progresses in versions, the definition of the API also progresses in versions.

The types in this crate are reproducible: deserializing a payload into a type, serializing it, and then deserializing it again will work.

Defined are a number of modules defining types returned by or owned by resource categories. For example, gateway are types used to interact with and returned by the gateway API. guild contains types owned by the Guild resource category. These types may be directly returned by, built on top of, or extended by other crates.

Some models have associated builders, which can be found in the twilight-util crate.




~46K SLoC