コメントリスト
トピックイットAPIで取得できるデータの種類を詳しくご説明します。
なお、各リクエストの{ } 部分は、必ずURLエンコードしてください。文字コードはShift-JISです。
リクエストURL
- 機能：
- 条件にマッチしたコメントリストを取得する。
上記のリクエスト例の場合は、topic_id（トピックのID）でトピックを指定し、そのトピックにつけられているコメントを3件取得します。
リクエスト
| GET | 内容 |
|---|---|
| /api/v1/comments/topics | 全コメント |
| /api/v1/comments/topics/{comma-separated list of topic ids} | {topic ids}にマッチするコメント |
| /api/v1/comments/topics/{topic id} | {topic id}にマッチするコメント |
| /api/v1/comments/users/{user name} | {user name}のコメント |
| /api/v1/comments/users/{comma-separated list of user names} | {user names}にマッチするコメント (e.g. GET /users/Hiroky,裸族/comments) |
| /api/v1/comments/topics/{topic id}/votes | コメント拍手の付いたコメント |
共通パラメーター
| パラメータ名 | パラメータ | 値 | デフォルト | 内容 |
|---|---|---|---|---|
| 検索開始投稿日時 | min_day | Number | - | UNIX epoch |
| 検索終了投稿日時 | max_day | Number | - | UNIX epoch |
| ソート（コメント日時） | sort_day | String | desc | desc, asc |
| コメント数 | count | Number | - | 取得件数 |
レスポンス
| 項目名 | パラメータ |
|---|---|
| コメント日時 | date |
| コメントid | comment_id |
| コメント拍手数 | comment_votes |
| コメント投稿者名 | user |
| コメント内容 | comment |
| コメント表情 | comment_feeling |
サンプルレスポンス
以下は、/api/v1/comments/topics/1?count=3のリクエストに対するレスポンスです。
