25
25
$ref : ' #/components/schemas/UserData'
26
26
' 401 ' :
27
27
description : ' Ошибка авторизации'
28
- ' 400 ' :
29
- description : ' Некорректный запрос '
28
+ ' 404 ' :
29
+ description : ' Не найдено '
30
30
/user/favorites :
31
31
get :
32
32
security :
40
40
$ref : ' #/components/schemas/QuestionData'
41
41
' 401 ' :
42
42
description : ' Ошибка авторизации'
43
- ' 400 ' :
44
- description : ' Некорректный запрос '
43
+ ' 404 ' :
44
+ description : ' Не найдено '
45
45
/user/favorites/{questionId} :
46
46
post :
47
47
summary : ' Добавление вопроса в избранные'
67
67
' 401 ' :
68
68
description : ' Ошибка авторизации'
69
69
' 400 ' :
70
- description : ' Некорректный запрос'
70
+ description : ' Неправильный, некорректный запрос'
71
71
' 404 ' :
72
72
description : ' Не найдено'
73
73
delete :
@@ -94,13 +94,15 @@ paths:
94
94
' 401 ' :
95
95
description : ' Ошибка авторизации'
96
96
' 400 ' :
97
- description : ' Некорректный запрос'
97
+ description : ' Неправильный, некорректный запрос'
98
+ ' 404 ' :
99
+ description : ' Не найдено'
98
100
/tags :
99
101
get :
100
102
summary : ' Поиск по тэгам'
101
103
parameters :
102
104
- in : query
103
- name : q
105
+ name : search
104
106
schema :
105
107
type : string
106
108
required : true
@@ -118,7 +120,7 @@ paths:
118
120
type : string
119
121
$ref : ' #/components/schemas/TagData'
120
122
' 400 ' :
121
- description : ' Некорректный запрос'
123
+ description : ' Неправильный, некорректный запрос'
122
124
post :
123
125
security :
124
126
- bearerAuth : []
@@ -148,7 +150,7 @@ paths:
148
150
' 401 ' :
149
151
description : ' Ошибка авторизации'
150
152
' 400 ' :
151
- description : ' Некорректный запрос'
153
+ description : ' Неправильный, некорректный запрос'
152
154
/questions :
153
155
get :
154
156
summary : ' Поиск по вопросам'
@@ -170,7 +172,7 @@ paths:
170
172
type : string
171
173
$ref : ' #/components/schemas/QuestionData'
172
174
' 400 ' :
173
- description : ' Некорректный запрос'
175
+ description : ' Неправильный, некорректный запрос'
174
176
post :
175
177
security :
176
178
- bearerAuth : []
@@ -211,7 +213,7 @@ paths:
211
213
' 401 ' :
212
214
description : ' Ошибка авторизации'
213
215
' 400 ' :
214
- description : ' Некорректный запрос'
216
+ description : ' Неправильный, некорректный запрос'
215
217
/questions/{questionId} :
216
218
get :
217
219
summary : ' Вывод вопроса'
@@ -230,7 +232,7 @@ paths:
230
232
schema :
231
233
$ref : ' #/components/schemas/QuestionData'
232
234
' 400 ' :
233
- description : ' Некорректный запрос'
235
+ description : ' Неправильный, некорректный запрос'
234
236
delete :
235
237
summary : ' Удаление вопроса'
236
238
parameters :
@@ -257,7 +259,7 @@ paths:
257
259
' 403 ' :
258
260
description : ' Недостаточно прав доступа'
259
261
' 400 ' :
260
- description : ' Некорректный запрос'
262
+ description : ' Неправильный, некорректный запрос'
261
263
patch :
262
264
summary : ' Восстановление вопроса'
263
265
parameters :
@@ -284,10 +286,10 @@ paths:
284
286
' 403 ' :
285
287
description : ' Недостаточно прав доступа'
286
288
' 400 ' :
287
- description : ' Некорректный запрос'
289
+ description : ' Неправильный, некорректный запрос'
288
290
/questions/{questionId}/rate :
289
291
post :
290
- summary : ' Изменение рейтинга для вопроса'
292
+ summary : ' Поднятия рейтинга для вопроса'
291
293
parameters :
292
294
- in : path
293
295
name : questionId
@@ -297,58 +299,30 @@ paths:
297
299
description : ' Идентификатор вопроса'
298
300
security :
299
301
- bearerAuth : []
300
- description : ' Изменение рейтинга вопроса'
302
+ description : ' Поднятие/понижение рейтинга вопроса'
301
303
requestBody :
302
- description : ' Данные для изменения рейтинга вопроса'
304
+ description : ' Данные для поднятия/понижения рейтинга вопроса'
303
305
content :
304
306
application/json :
305
307
schema :
306
- type : object
307
308
properties :
308
309
volume :
309
310
type : number
310
311
example : -1
311
- required :
312
- - volume
313
312
responses :
314
313
' 200 ' :
315
- description : ' Ответ после запроса на изменение рейтинга вопроса'
314
+ description : ' Ответ после запроса поднятие/понижения рейтинга вопроса'
316
315
content :
317
316
application/json :
318
317
schema :
319
- properties :
320
- message :
321
- type : string
322
- example : Рейтинг повышен
323
- ' 401 ' :
324
- description : ' Ошибка авторизации'
325
- ' 400 ' :
326
- description : ' Некорректный запрос'
327
- delete :
328
- summary : ' Удаление оценки для вопроса'
329
- parameters :
330
- - in : path
331
- name : questionId
332
- schema :
333
- type : string
334
- required : true
335
- description : ' Идентификатор вопроса'
336
- security :
337
- - bearerAuth : []
338
- responses :
339
- ' 200 ' :
340
- description : ' Ответ после запроса на удаления оценки вопроса'
341
- content :
342
- application/json :
343
- schema :
344
- properties :
345
- message :
346
- type : string
347
- example : Оценка удалена
318
+ type : array
319
+ items :
320
+ type : string
321
+ $ref : ' #/components/schemas/RateData'
348
322
' 401 ' :
349
323
description : ' Ошибка авторизации'
350
- ' 400 ' :
351
- description : ' Некорректный запрос '
324
+ ' 404 ' :
325
+ description : ' Не найдено '
352
326
/questions/{questionId}/comments :
353
327
get :
354
328
summary : ' Вывод комментарий вопроса'
@@ -366,9 +340,9 @@ paths:
366
340
application/json :
367
341
schema :
368
342
$ref : ' #/components/schemas/CommentData'
369
- ' 400 ' :
370
- description : ' Некорректный запрос '
371
- post :
343
+ ' 404 ' :
344
+ description : ' Не найдено '
345
+ post :
372
346
summary : ' Добавление комментарий вопроса'
373
347
parameters :
374
348
- in : path
@@ -404,85 +378,9 @@ paths:
404
378
' 401 ' :
405
379
description : ' Ошибка авторизации'
406
380
' 400 ' :
407
- description : ' Некорректный запрос'
381
+ description : ' Неправильный, некорректный запрос'
408
382
' 404 ' :
409
383
description : ' Не найдено'
410
- /questions/{questionId}/comments/{commentId}/rate :
411
- post :
412
- summary : ' Изменение рейтинга для комментария'
413
- parameters :
414
- - in : path
415
- name : questionId
416
- schema :
417
- type : string
418
- required : true
419
- description : ' Идентификатор вопроса'
420
- - in : path
421
- name : commentId
422
- schema :
423
- type : string
424
- required : true
425
- description : ' Идентификатор комментария'
426
- security :
427
- - bearerAuth : []
428
- description : ' Изменение рейтинга комментария'
429
- requestBody :
430
- description : ' Данные для изменения рейтинга комментария'
431
- content :
432
- application/json :
433
- schema :
434
- type : object
435
- properties :
436
- volume :
437
- type : number
438
- example : -1
439
- required :
440
- - volume
441
- responses :
442
- ' 200 ' :
443
- description : ' Ответ после запроса на изменение рейтинга комментария'
444
- content :
445
- application/json :
446
- schema :
447
- properties :
448
- message :
449
- type : string
450
- example : Рейтинг повышен
451
- ' 401 ' :
452
- description : ' Ошибка авторизации'
453
- ' 400 ' :
454
- description : ' Некорректный запрос'
455
- delete :
456
- summary : ' Удаление оценки для комментария'
457
- parameters :
458
- - in : path
459
- name : questionId
460
- schema :
461
- type : string
462
- required : true
463
- description : ' Идентификатор вопроса'
464
- - in : path
465
- name : commentId
466
- schema :
467
- type : string
468
- required : true
469
- description : ' Идентификатор комментария'
470
- security :
471
- - bearerAuth : []
472
- responses :
473
- ' 200 ' :
474
- description : ' Ответ после запросана на удаление оценки комментария'
475
- content :
476
- application/json :
477
- schema :
478
- properties :
479
- message :
480
- type : string
481
- example : Оценка удалена
482
- ' 401 ' :
483
- description : ' Ошибка авторизации'
484
- ' 400 ' :
485
- description : ' Некорректный запрос'
486
384
components :
487
385
securitySchemes :
488
386
bearerAuth :
@@ -525,25 +423,15 @@ components:
525
423
full : ' https://avatars.githubusercontent.com/u/93570249?v=4'
526
424
RateData :
527
425
properties :
528
- _id :
529
- type : string
530
- example : ' 61e299dfsl3a51al5261e23d'
531
-
532
- rateFrom :
426
+ user :
533
427
type : string
534
428
example : ' 61e299dfsl3a51al5261e65b'
535
- rateTo :
536
- type : string
537
- example : ' 61e395dfsl3a51al5261e39f'
538
429
volume :
539
430
type : number
540
431
example : -1
541
- ratedQuestion :
542
- type : string
543
- example : ' 61e395dfsl3a51al5261e24a'
544
- ratedComment :
432
+ _id :
545
433
type : string
546
- example : ' 61e395dfsl3a51al5261e93h '
434
+ example : ' 61e299dfsl3a51al5261e23d '
547
435
createdAt :
548
436
type : string
549
437
example : ' 2022-01-15T09:54:39.531Z'
@@ -568,6 +456,11 @@ components:
568
456
$ref : ' #/components/schemas/TagData'
569
457
user :
570
458
$ref : ' #/components/schemas/UserData'
459
+ rates :
460
+ type : array
461
+ items :
462
+ type : string
463
+ $ref : ' #/components/schemas/RateData'
571
464
createdAt :
572
465
type : string
573
466
example : ' 2022-01-15T09:54:39.531Z'
@@ -580,10 +473,6 @@ components:
580
473
commentsCount :
581
474
type : number
582
475
example : 0
583
- questionRateCount :
584
- type : number
585
- default : 0
586
- example : 2
587
476
TagData :
588
477
properties :
589
478
_id :
@@ -616,10 +505,6 @@ components:
616
505
questionId :
617
506
type : string
618
507
example : ' 62029815be7ea76826b79ff4'
619
- commentRateCount :
620
- type : number
621
- default : 0
622
- example : 2
623
508
createdAt :
624
509
type : string
625
510
example : ' 2022-01-15T09:54:39.531Z'
0 commit comments