Skip to content

A
api_document
Commit 267d8cb8 authored by RobertDing's avatar RobertDing
Browse files
Options

FIX - url 参数定义方式

parent b0d1fa98
Hide whitespace changes
Inline Side-by-side
Showing with 96 additions and 64 deletions
ascle.yaml
View file @ 267d8cb8
...@@ -876,10 +876,17 @@ paths: ...@@ -876,10 +876,17 @@ paths:
- name: 眼睛 - name: 眼睛
id: 123 id: 123
/topic/<topic_id>: /topic/{topic_id}:
get: get:
summary: 帖子详情 summary: 帖子详情
description: 帖子详情 description: 帖子详情
parameters:
- name: topic_id
in: path
description: 帖子ID
required: true
type: integer
format: integer
tags: tags:
- Topic - Topic
responses: responses:
...@@ -907,11 +914,17 @@ paths: ...@@ -907,11 +914,17 @@ paths:
image: "http://pic.gengmei.cc/2015/05/25/35fe857608-w" image: "http://pic.gengmei.cc/2015/05/25/35fe857608-w"
/topic/<topic_id>/reply: /topic/{topic_id}/reply:
get: get:
summary: 帖子回复 summary: 帖子回复
description: 帖子回复 description: 帖子回复
parameters: parameters:
- name: topic_id
in: path
description: 帖子ID
required: false
type: integer
format: integer
- name: page - name: page
in: query in: query
description: 请求第几页的数据，默认为1 description: 请求第几页的数据，默认为1
...@@ -950,78 +963,97 @@ paths: ...@@ -950,78 +963,97 @@ paths:
comment_user_type: 2 comment_user_type: 2
reply_date: 128833445 reply_date: 128833445
/topic/<topic_id>/reply/<reply_id>: /topic/{topic_id}/reply/{reply_id}:
post: post:
summary: 回复 summary: 回复
description: 回复话题，回复话题的回复 description: 回复话题，回复话题的回复
parameters:
- name: content
in: query
description: 回复的内容
required: true
type: string
format: string
tags:
- Topic
responses:
'200':
description: OK
/topic/<topic_id>/sink:
post:
summary: 话题下沉
description: 更改话题分值，话题往后排
parameters: parameters:
- name: topic_id - name: topic_id
in: query in: path
description: 话题ID description: 话题ID
required: true required: true
type: integer type: integer
format: integer format: integer
tags: - name: reply_id
- Topic in: path
responses: description: 回复ID
'200': required: true
description: OK type: integer
format: integer
- name: content
in: query
description: 回复的内容
required: true
type: string
format: string
tags:
- Topic
responses:
'200':
description: OK
/conversation: /topic/{topic_id}/sink:
get: post:
summary: 私信列表 summary: 话题下沉
description: 私信列表 description: 更改话题分值，话题往后排
parameters: parameters:
- name: page - name: topic_id
in: query in: path
description: 页数 description: 话题ID
required: false required: true
type: integer type: integer
format: integer format: integer
tags: tags:
- Conversation - Topic
responses: responses:
'200': '200':
description: OK description: OK
schema: {}
examples: /conversation:
application/json: get:
message: '' summary: 私信列表
error: 0 description: 私信列表
data: parameters:
- jump_value: "111549_602329" - name: page
is_new: false in: query
user_key: "111549_602329" description: 页数
doctor_id: "" required: false
id: 1270639 type: integer
jump_type: "6" format: integer
nickname: "发疯了的猫" tags:
portrait: "http://pic.gengmei.cc/2015/09/08/1226facfe0" - Conversation
hospital_id: "" responses:
last_reply_time: 145554334 '200':
text: "呵呵大" description: OK
schema: {}
examples:
application/json:
message: ''
error: 0
data:
- jump_value: "111549_602329"
is_new: false
user_key: "111549_602329"
doctor_id: ""
id: 1270639
jump_type: "6"
nickname: "发疯了的猫"
portrait: "http://pic.gengmei.cc/2015/09/08/1226facfe0"
hospital_id: ""
last_reply_time: 145554334
text: "呵呵大"
/conversation/<target_user_id>: /conversation/{target_user_id}:
get: get:
summary: 私信详情 summary: 私信详情
description: 私信详情 description: 私信详情
parameters:
- name: target_user_id
in: path
description: 私信用户ID
required: true
type: integer
format: integer
tags: tags:
- Conversation - Conversation
responses: responses:
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment