summaryrefslogtreecommitdiff
path: root/docs/federation/ratelimiting.md
diff options
context:
space:
mode:
authorLibravatar tobi <31960611+tsmethurst@users.noreply.github.com>2024-06-25 12:04:45 +0200
committerLibravatar GitHub <noreply@github.com>2024-06-25 12:04:45 +0200
commitfa710057c8ff234d76b75c0bddad6130ae20a779 (patch)
tree5e69f45f568e5f6960c11cc692c7b44cee0f55a3 /docs/federation/ratelimiting.md
parent[chore]: Bump github.com/gorilla/feeds from 1.1.2 to 1.2.0 (#3035) (diff)
downloadgotosocial-fa710057c8ff234d76b75c0bddad6130ae20a779.tar.xz
[docs] restructure federation section (#3038)
Diffstat (limited to 'docs/federation/ratelimiting.md')
-rw-r--r--docs/federation/ratelimiting.md7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/federation/ratelimiting.md b/docs/federation/ratelimiting.md
new file mode 100644
index 000000000..36bd11985
--- /dev/null
+++ b/docs/federation/ratelimiting.md
@@ -0,0 +1,7 @@
+# Request Throttling & Rate Limiting
+
+GoToSocial applies http request throttling and rate limiting to the ActivityPub API endpoints (inboxes, user endpoints, emojis, etc).
+
+This ensures that remote servers cannot flood a GoToSocial instance with spurious requests. Instead, remote servers making GET or POST requests to the ActivityPub API endpoints should respect 429 and 503 http codes, and take account of the `retry-after` http response header.
+
+For more details on request throttling and rate limiting behavior, please see the [throttling](../api/throttling.md) and [rate limiting](../api/ratelimiting.md) documents.