Move GET /api/v1/apps to GET /api/v1/pleroma/apps
[akkoma] / lib / pleroma / web / router.ex
1 # Pleroma: A lightweight social networking server
2 # Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
3 # SPDX-License-Identifier: AGPL-3.0-only
4
5 defmodule Pleroma.Web.Router do
6 use Pleroma.Web, :router
7
8 pipeline :accepts_html do
9 plug(:accepts, ["html"])
10 end
11
12 pipeline :accepts_html_xml do
13 plug(:accepts, ["html", "xml", "rss", "atom"])
14 end
15
16 pipeline :accepts_html_json do
17 plug(:accepts, ["html", "activity+json", "json"])
18 end
19
20 pipeline :accepts_html_xml_json do
21 plug(:accepts, ["html", "xml", "rss", "atom", "activity+json", "json"])
22 end
23
24 pipeline :accepts_xml_rss_atom do
25 plug(:accepts, ["xml", "rss", "atom"])
26 end
27
28 pipeline :browser do
29 plug(:accepts, ["html"])
30 plug(:fetch_session)
31 end
32
33 pipeline :oauth do
34 plug(:fetch_session)
35 plug(Pleroma.Web.Plugs.OAuthPlug)
36 plug(Pleroma.Web.Plugs.UserEnabledPlug)
37 plug(Pleroma.Web.Plugs.EnsureUserTokenAssignsPlug)
38 end
39
40 # Note: expects _user_ authentication (user-unbound app-bound tokens don't qualify)
41 pipeline :expect_user_authentication do
42 plug(Pleroma.Web.Plugs.ExpectAuthenticatedCheckPlug)
43 end
44
45 # Note: expects public instance or _user_ authentication (user-unbound tokens don't qualify)
46 pipeline :expect_public_instance_or_user_authentication do
47 plug(Pleroma.Web.Plugs.ExpectPublicOrAuthenticatedCheckPlug)
48 end
49
50 pipeline :authenticate do
51 plug(Pleroma.Web.Plugs.OAuthPlug)
52 plug(Pleroma.Web.Plugs.BasicAuthDecoderPlug)
53 plug(Pleroma.Web.Plugs.UserFetcherPlug)
54 plug(Pleroma.Web.Plugs.AuthenticationPlug)
55 end
56
57 pipeline :after_auth do
58 plug(Pleroma.Web.Plugs.UserEnabledPlug)
59 plug(Pleroma.Web.Plugs.SetUserSessionIdPlug)
60 plug(Pleroma.Web.Plugs.EnsureUserTokenAssignsPlug)
61 plug(Pleroma.Web.Plugs.UserTrackingPlug)
62 end
63
64 pipeline :base_api do
65 plug(:accepts, ["json"])
66 plug(:fetch_session)
67 plug(:authenticate)
68 plug(OpenApiSpex.Plug.PutApiSpec, module: Pleroma.Web.ApiSpec)
69 end
70
71 pipeline :no_auth_or_privacy_expectations_api do
72 plug(:base_api)
73 plug(:after_auth)
74 plug(Pleroma.Web.Plugs.IdempotencyPlug)
75 end
76
77 # Pipeline for app-related endpoints (no user auth checks — app-bound tokens must be supported)
78 pipeline :app_api do
79 plug(:no_auth_or_privacy_expectations_api)
80 end
81
82 pipeline :api do
83 plug(:expect_public_instance_or_user_authentication)
84 plug(:no_auth_or_privacy_expectations_api)
85 end
86
87 pipeline :authenticated_api do
88 plug(:expect_user_authentication)
89 plug(:no_auth_or_privacy_expectations_api)
90 plug(Pleroma.Web.Plugs.EnsureAuthenticatedPlug)
91 end
92
93 pipeline :admin_api do
94 plug(:expect_user_authentication)
95 plug(:base_api)
96 plug(Pleroma.Web.Plugs.AdminSecretAuthenticationPlug)
97 plug(:after_auth)
98 plug(Pleroma.Web.Plugs.EnsureAuthenticatedPlug)
99 plug(Pleroma.Web.Plugs.UserIsStaffPlug)
100 plug(Pleroma.Web.Plugs.IdempotencyPlug)
101 end
102
103 pipeline :require_admin do
104 plug(Pleroma.Web.Plugs.UserIsAdminPlug)
105 end
106
107 pipeline :mastodon_html do
108 plug(:browser)
109 plug(:authenticate)
110 plug(:after_auth)
111 end
112
113 pipeline :pleroma_html do
114 plug(:browser)
115 plug(:authenticate)
116 plug(Pleroma.Web.Plugs.EnsureUserTokenAssignsPlug)
117 end
118
119 pipeline :well_known do
120 plug(:accepts, ["json", "jrd+json", "xml", "xrd+xml"])
121 end
122
123 pipeline :config do
124 plug(:accepts, ["json", "xml"])
125 plug(OpenApiSpex.Plug.PutApiSpec, module: Pleroma.Web.ApiSpec)
126 end
127
128 pipeline :pleroma_api do
129 plug(:accepts, ["html", "json"])
130 plug(OpenApiSpex.Plug.PutApiSpec, module: Pleroma.Web.ApiSpec)
131 end
132
133 pipeline :mailbox_preview do
134 plug(:accepts, ["html"])
135
136 plug(:put_secure_browser_headers, %{
137 "content-security-policy" =>
138 "default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval'; style-src 'self' 'unsafe-inline' 'unsafe-eval'"
139 })
140 end
141
142 pipeline :http_signature do
143 plug(Pleroma.Web.Plugs.HTTPSignaturePlug)
144 plug(Pleroma.Web.Plugs.MappedSignatureToIdentityPlug)
145 end
146
147 pipeline :static_fe do
148 plug(Pleroma.Web.Plugs.StaticFEPlug)
149 end
150
151 scope "/api/v1/pleroma", Pleroma.Web.TwitterAPI do
152 pipe_through(:pleroma_api)
153
154 get("/password_reset/:token", PasswordController, :reset, as: :reset_password)
155 post("/password_reset", PasswordController, :do_reset, as: :reset_password)
156 get("/emoji", UtilController, :emoji)
157 get("/captcha", UtilController, :captcha)
158 get("/healthcheck", UtilController, :healthcheck)
159 end
160
161 scope "/api/v1/pleroma", Pleroma.Web do
162 pipe_through(:pleroma_api)
163 post("/uploader_callback/:upload_path", UploaderController, :callback)
164 end
165
166 scope "/api/v1/pleroma/admin", Pleroma.Web.AdminAPI do
167 pipe_through([:admin_api, :require_admin])
168
169 put("/users/disable_mfa", AdminAPIController, :disable_mfa)
170 put("/users/tag", AdminAPIController, :tag_users)
171 delete("/users/tag", AdminAPIController, :untag_users)
172
173 get("/users/:nickname/permission_group", AdminAPIController, :right_get)
174 get("/users/:nickname/permission_group/:permission_group", AdminAPIController, :right_get)
175
176 post("/users/:nickname/permission_group/:permission_group", AdminAPIController, :right_add)
177
178 delete(
179 "/users/:nickname/permission_group/:permission_group",
180 AdminAPIController,
181 :right_delete
182 )
183
184 post("/users/permission_group/:permission_group", AdminAPIController, :right_add_multiple)
185
186 delete(
187 "/users/permission_group/:permission_group",
188 AdminAPIController,
189 :right_delete_multiple
190 )
191
192 post("/users/follow", UserController, :follow)
193 post("/users/unfollow", UserController, :unfollow)
194 delete("/users", UserController, :delete)
195 post("/users", UserController, :create)
196 patch("/users/:nickname/toggle_activation", UserController, :toggle_activation)
197 patch("/users/activate", UserController, :activate)
198 patch("/users/deactivate", UserController, :deactivate)
199 patch("/users/approve", UserController, :approve)
200
201 get("/relay", RelayController, :index)
202 post("/relay", RelayController, :follow)
203 delete("/relay", RelayController, :unfollow)
204
205 post("/users/invite_token", InviteController, :create)
206 get("/users/invites", InviteController, :index)
207 post("/users/revoke_invite", InviteController, :revoke)
208 post("/users/email_invite", InviteController, :email)
209
210 get("/users/:nickname/password_reset", AdminAPIController, :get_password_reset)
211 patch("/users/force_password_reset", AdminAPIController, :force_password_reset)
212 get("/users/:nickname/credentials", AdminAPIController, :show_user_credentials)
213 patch("/users/:nickname/credentials", AdminAPIController, :update_user_credentials)
214
215 get("/users", UserController, :index)
216 get("/users/:nickname", UserController, :show)
217 get("/users/:nickname/statuses", AdminAPIController, :list_user_statuses)
218 get("/users/:nickname/chats", AdminAPIController, :list_user_chats)
219
220 get("/instances/:instance/statuses", AdminAPIController, :list_instance_statuses)
221
222 get("/instance_document/:name", InstanceDocumentController, :show)
223 patch("/instance_document/:name", InstanceDocumentController, :update)
224 delete("/instance_document/:name", InstanceDocumentController, :delete)
225
226 patch("/users/confirm_email", AdminAPIController, :confirm_email)
227 patch("/users/resend_confirmation_email", AdminAPIController, :resend_confirmation_email)
228
229 get("/reports", ReportController, :index)
230 get("/reports/:id", ReportController, :show)
231 patch("/reports", ReportController, :update)
232 post("/reports/:id/notes", ReportController, :notes_create)
233 delete("/reports/:report_id/notes/:id", ReportController, :notes_delete)
234
235 get("/statuses/:id", StatusController, :show)
236 put("/statuses/:id", StatusController, :update)
237 delete("/statuses/:id", StatusController, :delete)
238 get("/statuses", StatusController, :index)
239
240 get("/config", ConfigController, :show)
241 post("/config", ConfigController, :update)
242 get("/config/descriptions", ConfigController, :descriptions)
243 get("/need_reboot", AdminAPIController, :need_reboot)
244 get("/restart", AdminAPIController, :restart)
245
246 get("/moderation_log", AdminAPIController, :list_log)
247
248 post("/reload_emoji", AdminAPIController, :reload_emoji)
249 get("/stats", AdminAPIController, :stats)
250
251 get("/oauth_app", OAuthAppController, :index)
252 post("/oauth_app", OAuthAppController, :create)
253 patch("/oauth_app/:id", OAuthAppController, :update)
254 delete("/oauth_app/:id", OAuthAppController, :delete)
255
256 get("/media_proxy_caches", MediaProxyCacheController, :index)
257 post("/media_proxy_caches/delete", MediaProxyCacheController, :delete)
258 post("/media_proxy_caches/purge", MediaProxyCacheController, :purge)
259
260 get("/chats/:id", ChatController, :show)
261 get("/chats/:id/messages", ChatController, :messages)
262 delete("/chats/:id/messages/:message_id", ChatController, :delete_message)
263
264 get("/frontends", FrontendController, :index)
265 post("/frontends/install", FrontendController, :install)
266
267 post("/backups", AdminAPIController, :create_backup)
268 end
269
270 scope "/api/v1/pleroma/emoji", Pleroma.Web.PleromaAPI do
271 scope "/pack" do
272 pipe_through([:admin_api, :require_admin])
273
274 post("/", EmojiPackController, :create)
275 patch("/", EmojiPackController, :update)
276 delete("/", EmojiPackController, :delete)
277 end
278
279 scope "/pack" do
280 pipe_through(:api)
281
282 get("/", EmojiPackController, :show)
283 end
284
285 # Modifying packs
286 scope "/packs" do
287 pipe_through([:admin_api, :require_admin])
288
289 get("/import", EmojiPackController, :import_from_filesystem)
290 get("/remote", EmojiPackController, :remote)
291 post("/download", EmojiPackController, :download)
292
293 post("/files", EmojiFileController, :create)
294 patch("/files", EmojiFileController, :update)
295 delete("/files", EmojiFileController, :delete)
296 end
297
298 # Pack info / downloading
299 scope "/packs" do
300 pipe_through(:api)
301
302 get("/", EmojiPackController, :index)
303 get("/archive", EmojiPackController, :archive)
304 end
305 end
306
307 scope "/", Pleroma.Web.TwitterAPI do
308 pipe_through(:pleroma_html)
309
310 post("/main/ostatus", UtilController, :remote_subscribe)
311 get("/ostatus_subscribe", RemoteFollowController, :follow)
312 post("/ostatus_subscribe", RemoteFollowController, :do_follow)
313 end
314
315 scope "/api/pleroma", Pleroma.Web.TwitterAPI do
316 pipe_through(:authenticated_api)
317
318 post("/change_email", UtilController, :change_email)
319 post("/change_password", UtilController, :change_password)
320 post("/delete_account", UtilController, :delete_account)
321 put("/notification_settings", UtilController, :update_notificaton_settings)
322 post("/disable_account", UtilController, :disable_account)
323 end
324
325 scope "/api/pleroma", Pleroma.Web.PleromaAPI do
326 pipe_through(:authenticated_api)
327
328 post("/mutes_import", UserImportController, :mutes)
329 post("/blocks_import", UserImportController, :blocks)
330 post("/follow_import", UserImportController, :follow)
331
332 get("/accounts/mfa", TwoFactorAuthenticationController, :settings)
333 get("/accounts/mfa/backup_codes", TwoFactorAuthenticationController, :backup_codes)
334 get("/accounts/mfa/setup/:method", TwoFactorAuthenticationController, :setup)
335 post("/accounts/mfa/confirm/:method", TwoFactorAuthenticationController, :confirm)
336 delete("/accounts/mfa/:method", TwoFactorAuthenticationController, :disable)
337 end
338
339 scope "/oauth", Pleroma.Web.OAuth do
340 # Note: use /api/v1/accounts/verify_credentials for userinfo of signed-in user
341
342 get("/registration_details", OAuthController, :registration_details)
343
344 post("/mfa/verify", MFAController, :verify, as: :mfa_verify)
345 get("/mfa", MFAController, :show)
346
347 scope [] do
348 pipe_through(:oauth)
349
350 get("/authorize", OAuthController, :authorize)
351 post("/authorize", OAuthController, :create_authorization)
352 end
353
354 scope [] do
355 pipe_through(:fetch_session)
356
357 post("/token", OAuthController, :token_exchange)
358 post("/revoke", OAuthController, :token_revoke)
359 post("/mfa/challenge", MFAController, :challenge)
360 end
361
362 scope [] do
363 pipe_through(:browser)
364
365 get("/prepare_request", OAuthController, :prepare_request)
366 get("/:provider", OAuthController, :request)
367 get("/:provider/callback", OAuthController, :callback)
368 post("/register", OAuthController, :register)
369 end
370 end
371
372 scope "/api/v1/pleroma", Pleroma.Web.PleromaAPI do
373 pipe_through(:api)
374
375 get("/apps", AppController, :index)
376 get("/statuses/:id/reactions/:emoji", EmojiReactionController, :index)
377 get("/statuses/:id/reactions", EmojiReactionController, :index)
378 end
379
380 scope "/api/v0/pleroma", Pleroma.Web.PleromaAPI do
381 pipe_through(:authenticated_api)
382 get("/reports", ReportController, :index)
383 get("/reports/:id", ReportController, :show)
384 end
385
386 scope "/api/v1/pleroma", Pleroma.Web.PleromaAPI do
387 scope [] do
388 pipe_through(:authenticated_api)
389
390 post("/chats/by-account-id/:id", ChatController, :create)
391 get("/chats", ChatController, :index)
392 get("/chats/:id", ChatController, :show)
393 get("/chats/:id/messages", ChatController, :messages)
394 post("/chats/:id/messages", ChatController, :post_chat_message)
395 delete("/chats/:id/messages/:message_id", ChatController, :delete_message)
396 post("/chats/:id/read", ChatController, :mark_as_read)
397 post("/chats/:id/messages/:message_id/read", ChatController, :mark_message_as_read)
398
399 get("/conversations/:id/statuses", ConversationController, :statuses)
400 get("/conversations/:id", ConversationController, :show)
401 post("/conversations/read", ConversationController, :mark_as_read)
402 patch("/conversations/:id", ConversationController, :update)
403
404 put("/statuses/:id/reactions/:emoji", EmojiReactionController, :create)
405 delete("/statuses/:id/reactions/:emoji", EmojiReactionController, :delete)
406 post("/notifications/read", NotificationController, :mark_as_read)
407
408 get("/mascot", MascotController, :show)
409 put("/mascot", MascotController, :update)
410
411 post("/scrobble", ScrobbleController, :create)
412
413 get("/backups", BackupController, :index)
414 post("/backups", BackupController, :create)
415 end
416
417 scope [] do
418 pipe_through(:api)
419 get("/accounts/:id/favourites", AccountController, :favourites)
420 end
421
422 scope [] do
423 pipe_through(:authenticated_api)
424
425 post("/accounts/:id/subscribe", AccountController, :subscribe)
426 post("/accounts/:id/unsubscribe", AccountController, :unsubscribe)
427 end
428
429 post("/accounts/confirmation_resend", AccountController, :confirmation_resend)
430 end
431
432 scope "/api/v1/pleroma", Pleroma.Web.PleromaAPI do
433 pipe_through(:api)
434 get("/accounts/:id/scrobbles", ScrobbleController, :index)
435 get("/federation_status", InstancesController, :show)
436 end
437
438 scope "/api/v2/pleroma", Pleroma.Web.PleromaAPI do
439 scope [] do
440 pipe_through(:authenticated_api)
441 get("/chats", ChatController, :index2)
442 end
443 end
444
445 scope "/api/v1", Pleroma.Web.MastodonAPI do
446 pipe_through(:authenticated_api)
447
448 get("/accounts/verify_credentials", AccountController, :verify_credentials)
449 patch("/accounts/update_credentials", AccountController, :update_credentials)
450
451 get("/accounts/relationships", AccountController, :relationships)
452 get("/accounts/:id/lists", AccountController, :lists)
453 get("/accounts/:id/identity_proofs", AccountController, :identity_proofs)
454 get("/endorsements", AccountController, :endorsements)
455 get("/blocks", AccountController, :blocks)
456 get("/mutes", AccountController, :mutes)
457
458 post("/follows", AccountController, :follow_by_uri)
459 post("/accounts/:id/follow", AccountController, :follow)
460 post("/accounts/:id/unfollow", AccountController, :unfollow)
461 post("/accounts/:id/block", AccountController, :block)
462 post("/accounts/:id/unblock", AccountController, :unblock)
463 post("/accounts/:id/mute", AccountController, :mute)
464 post("/accounts/:id/unmute", AccountController, :unmute)
465
466 get("/conversations", ConversationController, :index)
467 post("/conversations/:id/read", ConversationController, :mark_as_read)
468 delete("/conversations/:id", ConversationController, :delete)
469
470 get("/domain_blocks", DomainBlockController, :index)
471 post("/domain_blocks", DomainBlockController, :create)
472 delete("/domain_blocks", DomainBlockController, :delete)
473
474 get("/filters", FilterController, :index)
475
476 post("/filters", FilterController, :create)
477 get("/filters/:id", FilterController, :show)
478 put("/filters/:id", FilterController, :update)
479 delete("/filters/:id", FilterController, :delete)
480
481 get("/follow_requests", FollowRequestController, :index)
482 post("/follow_requests/:id/authorize", FollowRequestController, :authorize)
483 post("/follow_requests/:id/reject", FollowRequestController, :reject)
484
485 get("/lists", ListController, :index)
486 get("/lists/:id", ListController, :show)
487 get("/lists/:id/accounts", ListController, :list_accounts)
488
489 delete("/lists/:id", ListController, :delete)
490 post("/lists", ListController, :create)
491 put("/lists/:id", ListController, :update)
492 post("/lists/:id/accounts", ListController, :add_to_list)
493 delete("/lists/:id/accounts", ListController, :remove_from_list)
494
495 get("/markers", MarkerController, :index)
496 post("/markers", MarkerController, :upsert)
497
498 post("/media", MediaController, :create)
499 get("/media/:id", MediaController, :show)
500 put("/media/:id", MediaController, :update)
501
502 get("/notifications", NotificationController, :index)
503 get("/notifications/:id", NotificationController, :show)
504
505 post("/notifications/:id/dismiss", NotificationController, :dismiss)
506 post("/notifications/clear", NotificationController, :clear)
507 delete("/notifications/destroy_multiple", NotificationController, :destroy_multiple)
508 # Deprecated: was removed in Mastodon v3, use `/notifications/:id/dismiss` instead
509 post("/notifications/dismiss", NotificationController, :dismiss_via_body)
510
511 post("/polls/:id/votes", PollController, :vote)
512
513 post("/reports", ReportController, :create)
514
515 get("/scheduled_statuses", ScheduledActivityController, :index)
516 get("/scheduled_statuses/:id", ScheduledActivityController, :show)
517
518 put("/scheduled_statuses/:id", ScheduledActivityController, :update)
519 delete("/scheduled_statuses/:id", ScheduledActivityController, :delete)
520
521 # Unlike `GET /api/v1/accounts/:id/favourites`, demands authentication
522 get("/favourites", StatusController, :favourites)
523 get("/bookmarks", StatusController, :bookmarks)
524
525 post("/statuses", StatusController, :create)
526 delete("/statuses/:id", StatusController, :delete)
527 post("/statuses/:id/reblog", StatusController, :reblog)
528 post("/statuses/:id/unreblog", StatusController, :unreblog)
529 post("/statuses/:id/favourite", StatusController, :favourite)
530 post("/statuses/:id/unfavourite", StatusController, :unfavourite)
531 post("/statuses/:id/pin", StatusController, :pin)
532 post("/statuses/:id/unpin", StatusController, :unpin)
533 post("/statuses/:id/bookmark", StatusController, :bookmark)
534 post("/statuses/:id/unbookmark", StatusController, :unbookmark)
535 post("/statuses/:id/mute", StatusController, :mute_conversation)
536 post("/statuses/:id/unmute", StatusController, :unmute_conversation)
537
538 post("/push/subscription", SubscriptionController, :create)
539 get("/push/subscription", SubscriptionController, :show)
540 put("/push/subscription", SubscriptionController, :update)
541 delete("/push/subscription", SubscriptionController, :delete)
542
543 get("/suggestions", SuggestionController, :index)
544
545 get("/timelines/home", TimelineController, :home)
546 get("/timelines/direct", TimelineController, :direct)
547 get("/timelines/list/:list_id", TimelineController, :list)
548 end
549
550 scope "/api/web", Pleroma.Web do
551 pipe_through(:authenticated_api)
552
553 # Backend-obscure settings blob for MastoFE, don't parse/reuse elsewhere
554 put("/settings", MastoFEController, :put_settings)
555 end
556
557 scope "/api/v1", Pleroma.Web.MastodonAPI do
558 pipe_through(:app_api)
559
560 post("/apps", AppController, :create)
561 get("/apps/verify_credentials", AppController, :verify_credentials)
562 end
563
564 scope "/api/v1", Pleroma.Web.MastodonAPI do
565 pipe_through(:api)
566
567 get("/accounts/search", SearchController, :account_search)
568 get("/search", SearchController, :search)
569
570 get("/accounts/:id/statuses", AccountController, :statuses)
571 get("/accounts/:id/followers", AccountController, :followers)
572 get("/accounts/:id/following", AccountController, :following)
573 get("/accounts/:id", AccountController, :show)
574
575 post("/accounts", AccountController, :create)
576
577 get("/instance", InstanceController, :show)
578 get("/instance/peers", InstanceController, :peers)
579
580 get("/statuses", StatusController, :index)
581 get("/statuses/:id", StatusController, :show)
582 get("/statuses/:id/context", StatusController, :context)
583 get("/statuses/:id/card", StatusController, :card)
584 get("/statuses/:id/favourited_by", StatusController, :favourited_by)
585 get("/statuses/:id/reblogged_by", StatusController, :reblogged_by)
586
587 get("/custom_emojis", CustomEmojiController, :index)
588
589 get("/trends", MastodonAPIController, :empty_array)
590
591 get("/timelines/public", TimelineController, :public)
592 get("/timelines/tag/:tag", TimelineController, :hashtag)
593
594 get("/polls/:id", PollController, :show)
595 end
596
597 scope "/api/v2", Pleroma.Web.MastodonAPI do
598 pipe_through(:api)
599 get("/search", SearchController, :search2)
600
601 post("/media", MediaController, :create2)
602 end
603
604 scope "/api", Pleroma.Web do
605 pipe_through(:config)
606
607 get("/pleroma/frontend_configurations", TwitterAPI.UtilController, :frontend_configurations)
608 end
609
610 scope "/api", Pleroma.Web do
611 pipe_through(:api)
612
613 get(
614 "/account/confirm_email/:user_id/:token",
615 TwitterAPI.Controller,
616 :confirm_email,
617 as: :confirm_email
618 )
619 end
620
621 scope "/api" do
622 pipe_through(:base_api)
623
624 get("/openapi", OpenApiSpex.Plug.RenderSpec, [])
625 end
626
627 scope "/api", Pleroma.Web, as: :authenticated_twitter_api do
628 pipe_through(:authenticated_api)
629
630 get("/oauth_tokens", TwitterAPI.Controller, :oauth_tokens)
631 delete("/oauth_tokens/:id", TwitterAPI.Controller, :revoke_token)
632 end
633
634 scope "/", Pleroma.Web do
635 # Note: html format is supported only if static FE is enabled
636 # Note: http signature is only considered for json requests (no auth for non-json requests)
637 pipe_through([:accepts_html_json, :http_signature, :static_fe])
638
639 get("/objects/:uuid", OStatus.OStatusController, :object)
640 get("/activities/:uuid", OStatus.OStatusController, :activity)
641 get("/notice/:id", OStatus.OStatusController, :notice)
642
643 # Mastodon compatibility routes
644 get("/users/:nickname/statuses/:id", OStatus.OStatusController, :object)
645 get("/users/:nickname/statuses/:id/activity", OStatus.OStatusController, :activity)
646 end
647
648 scope "/", Pleroma.Web do
649 # Note: html format is supported only if static FE is enabled
650 # Note: http signature is only considered for json requests (no auth for non-json requests)
651 pipe_through([:accepts_html_xml_json, :http_signature, :static_fe])
652
653 # Note: returns user _profile_ for json requests, redirects to user _feed_ for non-json ones
654 get("/users/:nickname", Feed.UserController, :feed_redirect, as: :user_feed)
655 end
656
657 scope "/", Pleroma.Web do
658 # Note: html format is supported only if static FE is enabled
659 pipe_through([:accepts_html_xml, :static_fe])
660
661 get("/users/:nickname/feed", Feed.UserController, :feed, as: :user_feed)
662 end
663
664 scope "/", Pleroma.Web do
665 pipe_through(:accepts_html)
666 get("/notice/:id/embed_player", OStatus.OStatusController, :notice_player)
667 end
668
669 scope "/", Pleroma.Web do
670 pipe_through(:accepts_xml_rss_atom)
671 get("/tags/:tag", Feed.TagController, :feed, as: :tag_feed)
672 end
673
674 scope "/", Pleroma.Web do
675 pipe_through(:browser)
676 get("/mailer/unsubscribe/:token", Mailer.SubscriptionController, :unsubscribe)
677 end
678
679 pipeline :ap_service_actor do
680 plug(:accepts, ["activity+json", "json"])
681 end
682
683 # Server to Server (S2S) AP interactions
684 pipeline :activitypub do
685 plug(:ap_service_actor)
686 plug(:http_signature)
687 end
688
689 # Client to Server (C2S) AP interactions
690 pipeline :activitypub_client do
691 plug(:ap_service_actor)
692 plug(:fetch_session)
693 plug(:authenticate)
694 plug(:after_auth)
695 end
696
697 scope "/", Pleroma.Web.ActivityPub do
698 pipe_through([:activitypub_client])
699
700 get("/api/ap/whoami", ActivityPubController, :whoami)
701 get("/users/:nickname/inbox", ActivityPubController, :read_inbox)
702
703 get("/users/:nickname/outbox", ActivityPubController, :outbox)
704 post("/users/:nickname/outbox", ActivityPubController, :update_outbox)
705 post("/api/ap/upload_media", ActivityPubController, :upload_media)
706
707 # The following two are S2S as well, see `ActivityPub.fetch_follow_information_for_user/1`:
708 get("/users/:nickname/followers", ActivityPubController, :followers)
709 get("/users/:nickname/following", ActivityPubController, :following)
710 get("/users/:nickname/collections/featured", ActivityPubController, :pinned)
711 end
712
713 scope "/", Pleroma.Web.ActivityPub do
714 pipe_through(:activitypub)
715 post("/inbox", ActivityPubController, :inbox)
716 post("/users/:nickname/inbox", ActivityPubController, :inbox)
717 end
718
719 scope "/relay", Pleroma.Web.ActivityPub do
720 pipe_through(:ap_service_actor)
721
722 get("/", ActivityPubController, :relay)
723
724 scope [] do
725 pipe_through(:http_signature)
726 post("/inbox", ActivityPubController, :inbox)
727 end
728
729 get("/following", ActivityPubController, :relay_following)
730 get("/followers", ActivityPubController, :relay_followers)
731 end
732
733 scope "/internal/fetch", Pleroma.Web.ActivityPub do
734 pipe_through(:ap_service_actor)
735
736 get("/", ActivityPubController, :internal_fetch)
737 post("/inbox", ActivityPubController, :inbox)
738 end
739
740 scope "/.well-known", Pleroma.Web do
741 pipe_through(:well_known)
742
743 get("/host-meta", WebFinger.WebFingerController, :host_meta)
744 get("/webfinger", WebFinger.WebFingerController, :webfinger)
745 get("/nodeinfo", Nodeinfo.NodeinfoController, :schemas)
746 end
747
748 scope "/nodeinfo", Pleroma.Web do
749 get("/:version", Nodeinfo.NodeinfoController, :nodeinfo)
750 end
751
752 scope "/", Pleroma.Web do
753 pipe_through(:api)
754
755 get("/web/manifest.json", MastoFEController, :manifest)
756 end
757
758 scope "/", Pleroma.Web do
759 pipe_through(:mastodon_html)
760
761 get("/web/login", MastodonAPI.AuthController, :login)
762 delete("/auth/sign_out", MastodonAPI.AuthController, :logout)
763
764 post("/auth/password", MastodonAPI.AuthController, :password_reset)
765
766 get("/web/*path", MastoFEController, :index)
767
768 get("/embed/:id", EmbedController, :show)
769 end
770
771 scope "/proxy/", Pleroma.Web do
772 get("/preview/:sig/:url", MediaProxy.MediaProxyController, :preview)
773 get("/preview/:sig/:url/:filename", MediaProxy.MediaProxyController, :preview)
774 get("/:sig/:url", MediaProxy.MediaProxyController, :remote)
775 get("/:sig/:url/:filename", MediaProxy.MediaProxyController, :remote)
776 end
777
778 if Pleroma.Config.get(:env) == :dev do
779 scope "/dev" do
780 pipe_through([:mailbox_preview])
781
782 forward("/mailbox", Plug.Swoosh.MailboxPreview, base_path: "/dev/mailbox")
783 end
784 end
785
786 # Test-only routes needed to test action dispatching and plug chain execution
787 if Pleroma.Config.get(:env) == :test do
788 @test_actions [
789 :do_oauth_check,
790 :fallback_oauth_check,
791 :skip_oauth_check,
792 :fallback_oauth_skip_publicity_check,
793 :skip_oauth_skip_publicity_check,
794 :missing_oauth_check_definition
795 ]
796
797 scope "/test/api", Pleroma.Tests do
798 pipe_through(:api)
799
800 for action <- @test_actions do
801 get("/#{action}", AuthTestController, action)
802 end
803 end
804
805 scope "/test/authenticated_api", Pleroma.Tests do
806 pipe_through(:authenticated_api)
807
808 for action <- @test_actions do
809 get("/#{action}", AuthTestController, action)
810 end
811 end
812 end
813
814 scope "/", Pleroma.Web.MongooseIM do
815 get("/user_exists", MongooseIMController, :user_exists)
816 get("/check_password", MongooseIMController, :check_password)
817 end
818
819 scope "/", Pleroma.Web.Fallback do
820 get("/registration/:token", RedirectController, :registration_page)
821 get("/:maybe_nickname_or_id", RedirectController, :redirector_with_meta)
822 match(:*, "/api/pleroma*path", LegacyPleromaApiRerouterPlug, [])
823 get("/api*path", RedirectController, :api_not_implemented)
824 get("/*path", RedirectController, :redirector_with_preload)
825
826 options("/*path", RedirectController, :empty)
827 end
828
829 # TODO: Change to Phoenix.Router.routes/1 for Phoenix 1.6.0+
830 def get_api_routes do
831 __MODULE__.__routes__()
832 |> Enum.reject(fn r -> r.plug == Pleroma.Web.Fallback.RedirectController end)
833 |> Enum.map(fn r ->
834 r.path
835 |> String.split("/", trim: true)
836 |> List.first()
837 end)
838 |> Enum.uniq()
839 end
840 end