File size: 4,028 Bytes
569cdb0 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 |
openapi: 3.0.1
info:
title: 单词本
description: 个性化的英文单词本,可以增加、删除和浏览单词本中的单词,背单词时从已有单词本中随机抽取单词生成句子或者段落。
version: "v1"
servers:
- url: http://127.0.0.1:8081
paths:
/get_wordbook:
get:
operationId: getWordbook
description: 展示单词列表
responses:
"200":
description: 列表展示完成
content:
application/json:
schema:
$ref: "#/components/schemas/getWordbook"
/generate_sentences:
post:
operationId: generateSentences
description: 背单词,生成句子
requestBody:
required: true
content:
application/json:
schema:
$ref: "#/components/schemas/generateSentences"
responses:
"200":
description: 句子生成成功
content:
application/json:
schema:
$ref: "#/components/schemas/responseSentences"
/add_word:
post:
operationId: addWord
description: 在单词本中添加一个单词
requestBody:
required: true
content:
application/json:
schema:
$ref: "#/components/schemas/addWord"
responses:
"200":
description: 单词添加成功
content:
application/json:
schema:
$ref: "#/components/schemas/messageResponse"
/delete_word:
delete:
operationId: deleteWord
description: 从单词本中删除一个单词
requestBody:
required: true
content:
application/json:
schema:
$ref: "#/components/schemas/deleteWord"
responses:
"200":
description: 单词删除成功
content:
application/json:
schema:
$ref: "#/components/schemas/messageResponse"
components:
schemas:
getWordbook:
type: object
required: [wordbook]
properties:
wordbook:
type: array
items:
type: string
description: 单词本单词列表
addWord:
type: object
required: [word]
properties:
word:
type: string
description: 需要添加到单词本中的一个单词
deleteWord:
type: object
required: [word]
properties:
word:
type: string
description: 需要删除的单词
generateSentences:
type: object
required: [word_number]
properties:
word_number:
type: integer
description: 几个单词
responseSentences:
type: object
required: [words]
properties:
words:
type: array
items:
type: string
description: 随机抽取的英文单词
messageResponse:
type: object
required: [message]
properties:
message:
type: string
description: 回复信息
|