基本住所
https://forum.hamcq.cn
本人確認
API の使用には、トークンベースの認証メカニズムが用いられます。
トークンを取得する
トークンを取得する
{
"識別子": "トビー",
"パスワード": "pass7word"
}
HTTP/1.1 200 OK
{
"トークン": "YACub2KLfe8mfmHPcUKtt6t2SMJOGPXnZbqhc3nX",
"ユーザーID": "1"
}
その後、以降の要求ヘッダーには、この認証トークンを含めることができます。
GET /api/forum HTTP/1.1
認証:トークン YACub2KLfe8mfmHPcUKtt6t2SMJOGPXnZbqhc3nX
2FAを有効にした場合、ログインリクエストは完了せず、「以下」というメッセージが表示されます。401 - 認証エラー
トピックを取得する - すべての議論を取得 (デフォルトのソートルールは-時間)
GET /api/discussions
GET /api/discussions?sort=-commentCount コメント数が多い順に並び替え
GET /api/discussions/{id} IDを使って議論を特定する
GET /api/discussions?include=user,lastPostedUser,firstPost,tags 指定したコンテンツへ戻る
テーマの作成
POST /api/discussions
ユーザー情報
GET /api/users/:idまたはユーザー名 IDまたはユーザー名を使って情報を取得する
すべてのグループを取得する
GET /api/groups
タグを取得する
GET /api/tags