src/api_routes.rs

   1 use actix_web::*;
   2 use lemmy_api::Perform;
   3 use lemmy_api_common::{comment::*, community::*, person::*, post::*, site::*, websocket::*};
   4 use lemmy_api_crud::PerformCrud;
   5 use lemmy_utils::rate_limit::RateLimit;
   6 use lemmy_websocket::{routes::chat_route, LemmyContext};
   7 use serde::Deserialize;
   8
   9 pub fn config(cfg: &mut web::ServiceConfig, rate_limit: &RateLimit) {
  10   cfg.service(
  11     web::scope("/api/v3")
  12       // Websocket
  13       .service(web::resource("/ws").to(chat_route))
  14       // Site
  15       .service(
  16         web::scope("/site")
  17           .wrap(rate_limit.message())
  18           .route("", web::get().to(route_get_crud::<GetSite>))
  19           // Admin Actions
  20           .route("", web::post().to(route_post_crud::<CreateSite>))
  21           .route("", web::put().to(route_post_crud::<EditSite>))
  22           .route("/config", web::get().to(route_get::<GetSiteConfig>))
  23           .route("/config", web::put().to(route_post::<SaveSiteConfig>)),
  24       )
  25       .service(
  26         web::resource("/modlog")
  27           .wrap(rate_limit.message())
  28           .route(web::get().to(route_get::<GetModlog>)),
  29       )
  30       .service(
  31         web::resource("/search")
  32           .wrap(rate_limit.search())
  33           .route(web::get().to(route_get::<Search>)),
  34       )
  35       .service(
  36         web::resource("/resolve_object")
  37           .wrap(rate_limit.message())
  38           .route(web::get().to(route_get::<ResolveObject>)),
  39       )
  40       // Community
  41       .service(
  42         web::resource("/community")
  43           .guard(guard::Post())
  44           .wrap(rate_limit.register())
  45           .route(web::post().to(route_post_crud::<CreateCommunity>)),
  46       )
  47       .service(
  48         web::scope("/community")
  49           .wrap(rate_limit.message())
  50           .route("", web::get().to(route_get_crud::<GetCommunity>))
  51           .route("", web::put().to(route_post_crud::<EditCommunity>))
  52           .route("/hide", web::put().to(route_post::<HideCommunity>))
  53           .route("/list", web::get().to(route_get_crud::<ListCommunities>))
  54           .route("/follow", web::post().to(route_post::<FollowCommunity>))
  55           .route("/block", web::post().to(route_post::<BlockCommunity>))
  56           .route(
  57             "/delete",
  58             web::post().to(route_post_crud::<DeleteCommunity>),
  59           )
  60           // Mod Actions
  61           .route(
  62             "/remove",
  63             web::post().to(route_post_crud::<RemoveCommunity>),
  64           )
  65           .route("/transfer", web::post().to(route_post::<TransferCommunity>))
  66           .route("/ban_user", web::post().to(route_post::<BanFromCommunity>))
  67           .route("/mod", web::post().to(route_post::<AddModToCommunity>))
  68           .route("/join", web::post().to(route_post::<CommunityJoin>))
  69           .route("/mod/join", web::post().to(route_post::<ModJoin>)),
  70       )
  71       // Post
  72       .service(
  73         // Handle POST to /post separately to add the post() rate limitter
  74         web::resource("/post")
  75           .guard(guard::Post())
  76           .wrap(rate_limit.post())
  77           .route(web::post().to(route_post_crud::<CreatePost>)),
  78       )
  79       .service(
  80         web::scope("/post")
  81           .wrap(rate_limit.message())
  82           .route("", web::get().to(route_get_crud::<GetPost>))
  83           .route("", web::put().to(route_post_crud::<EditPost>))
  84           .route("/delete", web::post().to(route_post_crud::<DeletePost>))
  85           .route("/remove", web::post().to(route_post_crud::<RemovePost>))
  86           .route(
  87             "/mark_as_read",
  88             web::post().to(route_post::<MarkPostAsRead>),
  89           )
  90           .route("/lock", web::post().to(route_post::<LockPost>))
  91           .route("/sticky", web::post().to(route_post::<StickyPost>))
  92           .route("/list", web::get().to(route_get_crud::<GetPosts>))
  93           .route("/like", web::post().to(route_post::<CreatePostLike>))
  94           .route("/save", web::put().to(route_post::<SavePost>))
  95           .route("/join", web::post().to(route_post::<PostJoin>))
  96           .route("/report", web::post().to(route_post::<CreatePostReport>))
  97           .route(
  98             "/report/resolve",
  99             web::put().to(route_post::<ResolvePostReport>),
 100           )
 101           .route("/report/list", web::get().to(route_get::<ListPostReports>))
 102           .route(
 103             "/site_metadata",
 104             web::get().to(route_get::<GetSiteMetadata>),
 105           ),
 106       )
 107       // Comment
 108       .service(
 109         // Handle POST to /comment separately to add the comment() rate limitter
 110         web::resource("/comment")
 111           .guard(guard::Post())
 112           .wrap(rate_limit.comment())
 113           .route(web::post().to(route_post_crud::<CreateComment>)),
 114       )
 115       .service(
 116         web::scope("/comment")
 117           .wrap(rate_limit.message())
 118           .route("", web::get().to(route_get_crud::<GetComment>))
 119           .route("", web::put().to(route_post_crud::<EditComment>))
 120           .route("/delete", web::post().to(route_post_crud::<DeleteComment>))
 121           .route("/remove", web::post().to(route_post_crud::<RemoveComment>))
 122           .route(
 123             "/mark_as_read",
 124             web::post().to(route_post::<MarkCommentAsRead>),
 125           )
 126           .route("/like", web::post().to(route_post::<CreateCommentLike>))
 127           .route("/save", web::put().to(route_post::<SaveComment>))
 128           .route("/list", web::get().to(route_get_crud::<GetComments>))
 129           .route("/report", web::post().to(route_post::<CreateCommentReport>))
 130           .route(
 131             "/report/resolve",
 132             web::put().to(route_post::<ResolveCommentReport>),
 133           )
 134           .route(
 135             "/report/list",
 136             web::get().to(route_get::<ListCommentReports>),
 137           ),
 138       )
 139       // Private Message
 140       .service(
 141         web::scope("/private_message")
 142           .wrap(rate_limit.message())
 143           .route("/list", web::get().to(route_get_crud::<GetPrivateMessages>))
 144           .route("", web::post().to(route_post_crud::<CreatePrivateMessage>))
 145           .route("", web::put().to(route_post_crud::<EditPrivateMessage>))
 146           .route(
 147             "/delete",
 148             web::post().to(route_post_crud::<DeletePrivateMessage>),
 149           )
 150           .route(
 151             "/mark_as_read",
 152             web::post().to(route_post::<MarkPrivateMessageAsRead>),
 153           ),
 154       )
 155       // User
 156       .service(
 157         // Account action, I don't like that it's in /user maybe /accounts
 158         // Handle /user/register separately to add the register() rate limitter
 159         web::resource("/user/register")
 160           .guard(guard::Post())
 161           .wrap(rate_limit.register())
 162           .route(web::post().to(route_post_crud::<Register>)),
 163       )
 164       .service(
 165         // Handle captcha separately
 166         web::resource("/user/get_captcha")
 167           .wrap(rate_limit.post())
 168           .route(web::get().to(route_get::<GetCaptcha>)),
 169       )
 170       // User actions
 171       .service(
 172         web::scope("/user")
 173           .wrap(rate_limit.message())
 174           .route("", web::get().to(route_get_crud::<GetPersonDetails>))
 175           .route("/mention", web::get().to(route_get::<GetPersonMentions>))
 176           .route(
 177             "/mention/mark_as_read",
 178             web::post().to(route_post::<MarkPersonMentionAsRead>),
 179           )
 180           .route("/replies", web::get().to(route_get::<GetReplies>))
 181           .route("/join", web::post().to(route_post::<UserJoin>))
 182           // Admin action. I don't like that it's in /user
 183           .route("/ban", web::post().to(route_post::<BanPerson>))
 184           .route("/banned", web::get().to(route_get::<GetBannedPersons>))
 185           .route("/block", web::post().to(route_post::<BlockPerson>))
 186           // Account actions. I don't like that they're in /user maybe /accounts
 187           .route("/login", web::post().to(route_post::<Login>))
 188           .route(
 189             "/delete_account",
 190             web::post().to(route_post_crud::<DeleteAccount>),
 191           )
 192           .route(
 193             "/password_reset",
 194             web::post().to(route_post::<PasswordReset>),
 195           )
 196           .route(
 197             "/password_change",
 198             web::post().to(route_post::<PasswordChangeAfterReset>),
 199           )
 200           // mark_all_as_read feels off being in this section as well
 201           .route(
 202             "/mark_all_as_read",
 203             web::post().to(route_post::<MarkAllAsRead>),
 204           )
 205           .route(
 206             "/save_user_settings",
 207             web::put().to(route_post::<SaveUserSettings>),
 208           )
 209           .route(
 210             "/change_password",
 211             web::put().to(route_post::<ChangePassword>),
 212           )
 213           .route("/report_count", web::get().to(route_get::<GetReportCount>))
 214           .route("/unread_count", web::get().to(route_get::<GetUnreadCount>))
 215           .route("/verify_email", web::post().to(route_post::<VerifyEmail>))
 216           .route("/leave_admin", web::post().to(route_post::<LeaveAdmin>)),
 217       )
 218       // Admin Actions
 219       .service(
 220         web::scope("/admin")
 221           .wrap(rate_limit.message())
 222           .route("/add", web::post().to(route_post::<AddAdmin>))
 223           .route(
 224             "/registration_application/count",
 225             web::get().to(route_get::<GetUnreadRegistrationApplicationCount>),
 226           )
 227           .route(
 228             "/registration_application/list",
 229             web::get().to(route_get::<ListRegistrationApplications>),
 230           )
 231           .route(
 232             "/registration_application/approve",
 233             web::put().to(route_post::<ApproveRegistrationApplication>),
 234           ),
 235       ),
 236   );
 237 }
 238
 239 async fn perform<Request>(
 240   data: Request,
 241   context: web::Data<LemmyContext>,
 242 ) -> Result<HttpResponse, Error>
 243 where
 244   Request: Perform,
 245   Request: Send + 'static,
 246 {
 247   let res = data
 248     .perform(&context, None)
 249     .await
 250     .map(|json| HttpResponse::Ok().json(json))?;
 251   Ok(res)
 252 }
 253
 254 async fn route_get<'a, Data>(
 255   data: web::Query<Data>,
 256   context: web::Data<LemmyContext>,
 257 ) -> Result<HttpResponse, Error>
 258 where
 259   Data: Deserialize<'a> + Send + 'static + Perform,
 260 {
 261   perform::<Data>(data.0, context).await
 262 }
 263
 264 async fn route_post<'a, Data>(
 265   data: web::Json<Data>,
 266   context: web::Data<LemmyContext>,
 267 ) -> Result<HttpResponse, Error>
 268 where
 269   Data: Deserialize<'a> + Send + 'static + Perform,
 270 {
 271   perform::<Data>(data.0, context).await
 272 }
 273
 274 async fn perform_crud<Request>(
 275   data: Request,
 276   context: web::Data<LemmyContext>,
 277 ) -> Result<HttpResponse, Error>
 278 where
 279   Request: PerformCrud,
 280   Request: Send + 'static,
 281 {
 282   let res = data
 283     .perform(&context, None)
 284     .await
 285     .map(|json| HttpResponse::Ok().json(json))?;
 286   Ok(res)
 287 }
 288
 289 async fn route_get_crud<'a, Data>(
 290   data: web::Query<Data>,
 291   context: web::Data<LemmyContext>,
 292 ) -> Result<HttpResponse, Error>
 293 where
 294   Data: Deserialize<'a> + Send + 'static + PerformCrud,
 295 {
 296   perform_crud::<Data>(data.0, context).await
 297 }
 298
 299 async fn route_post_crud<'a, Data>(
 300   data: web::Json<Data>,
 301   context: web::Data<LemmyContext>,
 302 ) -> Result<HttpResponse, Error>
 303 where
 304   Data: Deserialize<'a> + Send + 'static + PerformCrud,
 305 {
 306   perform_crud::<Data>(data.0, context).await
 307 }