chat.go/public/index.html

69 lines
1.9 KiB
HTML
Raw Normal View History

<!DOCTYPE html>
<html>
2018-08-02 17:28:05 +00:00
<head><title>API Docs</title></head>
<body>
2018-08-02 17:28:05 +00:00
<h1>Sample Chat - API Docs</h1>
<h2>Login</h2>
<ul>
<li>
<h3>POST /api/sessions
<br>
<code>{"sub":"<strong><em>jon@example.com</em></strong>"}</code>
</h3>
<pre><code># Ask for an auth code (swap sub)
2018-08-02 17:28:05 +00:00
curl -X POST http://localhost:4080/api/sessions \
-H 'Content-Type: application/json; charset=utf-8' \
2018-08-02 08:13:56 +00:00
-d '{"sub":"<strong><em>jon@example.com</em></strong>"}'
2018-08-02 17:28:05 +00:00
</code></pre>
</li>
<li>
<h3>POST /api/sessions/<strong><em>id</em></strong>
<br>
<code>{"otp":"<strong><em>auth-code</em></strong>"}</code>
</h3>
<pre><code># Validate auth code (swap session id, sub, and otp)
2018-08-02 08:13:56 +00:00
curl -X POST http://localhost:4080/api/sessions/<strong><em>xyz</em></strong> \
-H 'Content-Type: application/json; charset=utf-8' \
2018-08-02 08:13:56 +00:00
-d '{"otp":"<strong><em>secret123</em></strong>"}'
2018-08-02 17:28:05 +00:00
</code></pre>
</li>
</ul>
<h2>Messages</h2>
<ul>
<li>
<h3>POST /api/rooms/general
<br>
<code>Authorization: Bearer <strong><em>api-token</em></strong>
<br>{"message":"<strong><em>Hello, World!</em></strong>"}</code>
</h3>
<pre><code># Post a message (swap api-token)
curl -X POST http://localhost:4080/api/rooms/general \
2018-08-02 08:13:56 +00:00
-H 'Authorization: Bearer <strong><em>api-token</em></strong>' \
-H 'Content-Type: application/json; charset=utf-8' \
2018-08-02 08:13:56 +00:00
-d '{"message":"Hello, World!"}'
2018-08-02 17:28:05 +00:00
</code></pre>
</li>
<li>
<h3>GET /api/rooms/general
<br>
<code>Authorization: Bearer <strong><em>api-token</em></strong>
<br>{"message":"<strong><em>Hello, World!</em></strong>"}</code>
</h3>
<pre><code># Get a room's messages (swap api-token, since unix-epoch)
2018-08-02 17:28:05 +00:00
curl http://localhost:4080/api/rooms/general \
2018-08-02 08:13:56 +00:00
-H 'Authorization: Bearer <strong><em>api-token</em></strong>'
</code></pre>
2018-08-02 17:28:05 +00:00
</li>
</ul>
</body>
</html>