summaryrefslogtreecommitdiff
path: root/Documentation/source/reference/api.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/source/reference/api.rst')
-rw-r--r--Documentation/source/reference/api.rst53
1 files changed, 53 insertions, 0 deletions
diff --git a/Documentation/source/reference/api.rst b/Documentation/source/reference/api.rst
new file mode 100644
index 0000000..85081aa
--- /dev/null
+++ b/Documentation/source/reference/api.rst
@@ -0,0 +1,53 @@
+API Reference
+=============
+
+Search Index
+------------
+
+Path
+ ``/api/search``
+
+Purpose
+ Provides search data for the frontend search experience.
+
+Rules
+ Return public published content only. Keep the response shape stable for the
+ search client.
+
+Comments
+--------
+
+Path
+ ``/api/comments/[...comment]``
+
+Purpose
+ Handles Fuma Comments operations.
+
+Rules
+ Authentication and authorization belong on the server side. Client code
+ should not decide comment privileges.
+
+Auth
+----
+
+Path
+ ``/api/auth/[...all]``
+
+Purpose
+ Handles better-auth routes for OAuth and session behavior.
+
+Rules
+ Keep provider configuration in ``src/server/auth`` and environment
+ validation in ``src/env.js``.
+
+Feed
+----
+
+Path
+ ``/rss.xml``
+
+Purpose
+ Publishes feed output for readers and feed clients.
+
+Rules
+ Include published content only and keep route references canonical.