创建讨论
创建讨论
Path Parameters
- org required
组织的path
Header Parameters
- Authorization required
用户token(需以Bearer加空格开头)
- application/json
Request Body
- title string
讨论标题
- body string
讨论内容(md格式)
- categoryId string
讨论所属分类的id
- question string
当讨论为投票类型时候,投票主体的内容
- options string[]
当讨论为投票类型时候,投票选项
Responses
- 200
- 401
- 403
创建成功
- application/json
- Schema
- Example (from schema)
Schema
- id string
id
- title string
讨论的标题
- body string
讨论的正文(md格式)
- body_html string
讨论的正文(html格式)
- number int
讨论序号
- pinned boolean
讨论的置顶状态
- comments_count int
讨论评论数量
question object
讨论为投票类型时候,投票主体
id string讨论为投票类型时候,投票的主体id
question string讨论为投票类型时候,投票的主体内容
vote_total int讨论为投票类型时候,投票主体已投票总数
options array
讨论为投票类型时候,投票选项
id string讨论为投票类型时候,投票选项的id
vote_option string讨论为投票类型时候,投票的选项的内容
vote_order int讨论为投票类型时候,投票的选项排序
vote_total int讨论为投票类型时候,投票的选项当前投票数量
vote_total_percent string讨论为投票类型时候,投票的选项
vote_id string讨论为投票类型时候,所属的投票主体id
author object
login string创作者用户名
id string创作者用户id
avatar_url string创作者用户头像
url string创作者的详细信息的api地址
html_url string创作者的web主页url
followers_url string创作者的 followers url
followering_url string创作者的 followering url
gists_url string创作者的 gists url
starred_url string创作者的 starred url
subscriptions_url string创作者的 subscriptions url
organizations_url string创作者的 organizations url
repos_url string创作者的 repos url
events_url string创作者的 events url
received_events_url string创作者的 received events url
type string类型
site_admin string创作者的是否为管理员
- url string
讨论的api地址
- html_url string
讨论的web地址
- created_at string
创建时间
- updated_at string
更新时间
{
"id": "64a2791c36ca86246aed3612",
"title": "公告:大家好",
"body": "大家积极参与讨论",
"body_html": "大家积极参与讨论",
"number": 1,
"pinned": false,
"comments_count": 1,
"question": {
"id": "64a2791c36ca86246aed3612",
"question": "请大家来投票,支持那种开源方式?",
"vote_total": 1
},
"options": [
null
],
"author": {
"login": "mrpuatomgit",
"id": "63db126c0566d2f7d2c9498c",
"avatar_url": "https://img-host/uploads/user/1656318880150_5104.png",
"url": "https://api.atomgit.com/users/leige",
"html_url": "https://atomgit.com/mrpuatomgit",
"followers_url": null,
"followering_url": null,
"gists_url": null,
"starred_url": null,
"subscriptions_url": null,
"organizations_url": null,
"repos_url": null,
"events_url": null,
"received_events_url": null,
"type": "user",
"site_admin": false
},
"url": "https://api.atomgit.com/repos/test/public01",
"html_url": "https://atomgit.com/yourleige/zxjava/discussions/1",
"created_at": "2023-07-04T17:03:05+08:00",
"updated_at": "2023-07-04T17:03:05+08:00"
}
token不合法、请检查token是否正确
- application/json
- application/xml
- Schema
- Example (from schema)
Schema
- error string
错误名称
- error_description string
错误描述
{
"error": "invalid_token",
"error_description": "Invalid token, please provide correct token"
}
- Schema
- Example (from schema)
Schema
- error string
错误名称
- error_description string
错误描述
<root>
<error>invalid_token</error>
<error_description>Invalid token, please provide correct token</error_description>
</root>
权限异常
- application/json
- Schema
- Example (from schema)
Schema
- error_code string
错误名称
- error_message string
错误描述
{
"error_code": "string",
"error_message": "string"
}
Loading...