malpercio.dev
WIP! A BB-style forum, on the ATmosphere!
We're still working... we'll be back soon when we have something to show off!
node
typescript
hono
htmx
atproto
1meta {
2 name: Create Topic
3 type: http
4 seq: 2
5}
6
7post {
8 url: {{appview_url}}/api/topics
9}
10
11headers {
12 Content-Type: application/json
13}
14
15body:json {
16 {
17 "text": "This is a new topic",
18 "forumUri": "at://{{forum_did}}/space.atbb.forum.forum/self"
19 }
20}
21
22assert {
23 res.status: eq 201
24 res.body.uri: isDefined
25 res.body.cid: isDefined
26 res.body.rkey: isDefined
27}
28
29docs {
30 Create a new topic (thread starter post).
31
32 Required body:
33 {
34 "text": "Post text (1-10000 chars, trimmed)",
35 "forumUri": "at://did:plc:.../space.atbb.forum.forum/self" (optional, defaults to singleton forum)
36 }
37
38 Returns:
39 {
40 "uri": "at://did:plc:.../space.atbb.post/...",
41 "cid": "...",
42 "rkey": "..."
43 }
44
45 Requires authentication (valid session cookie).
46
47 Returns 400 for invalid text.
48 Returns 401 if not authenticated.
49 Returns 404 if forum not found.
50 Returns 503 if PDS unreachable (network error).
51 Returns 500 for server errors.
52}