|
464 | 464 | } |
465 | 465 | } |
466 | 466 | } |
| 467 | + }, |
| 468 | + "/api/requests/record": { |
| 469 | + "get": { |
| 470 | + "tags": ["Request"], |
| 471 | + "summary": "완료된 신청내역 조회", |
| 472 | + "description": "사용자가 신청한 커미션 중 완료된(COMPLETED) 내역을 조회합니다. 정렬 기능과 페이지네이션을 지원합니다.", |
| 473 | + "security": [ |
| 474 | + { |
| 475 | + "bearerAuth": [] |
| 476 | + } |
| 477 | + ], |
| 478 | + "parameters": [ |
| 479 | + { |
| 480 | + "name": "sort", |
| 481 | + "in": "query", |
| 482 | + "required": false, |
| 483 | + "schema": { |
| 484 | + "type": "string", |
| 485 | + "default": "latest", |
| 486 | + "enum": ["latest", "oldest", "price_low", "price_high"] |
| 487 | + }, |
| 488 | + "description": "정렬 방식 (latest: 최신순, oldest: 오래된순, price_low: 저가순, price_high: 고가순)" |
| 489 | + }, |
| 490 | + { |
| 491 | + "name": "page", |
| 492 | + "in": "query", |
| 493 | + "required": false, |
| 494 | + "schema": { |
| 495 | + "type": "integer", |
| 496 | + "default": 1 |
| 497 | + }, |
| 498 | + "description": "페이지 번호" |
| 499 | + }, |
| 500 | + { |
| 501 | + "name": "limit", |
| 502 | + "in": "query", |
| 503 | + "required": false, |
| 504 | + "schema": { |
| 505 | + "type": "integer", |
| 506 | + "default": 10 |
| 507 | + }, |
| 508 | + "description": "페이지당 항목 수" |
| 509 | + } |
| 510 | + ], |
| 511 | + "responses": { |
| 512 | + "200": { |
| 513 | + "description": "완료된 신청내역 조회 성공", |
| 514 | + "content": { |
| 515 | + "application/json": { |
| 516 | + "schema": { |
| 517 | + "type": "object", |
| 518 | + "properties": { |
| 519 | + "resultType": { "type": "string", "example": "SUCCESS" }, |
| 520 | + "error": { "type": "null", "example": null }, |
| 521 | + "success": { |
| 522 | + "type": "object", |
| 523 | + "properties": { |
| 524 | + "requests": { |
| 525 | + "type": "array", |
| 526 | + "items": { |
| 527 | + "type": "object", |
| 528 | + "properties": { |
| 529 | + "requestId": { "type": "integer", "example": 1 }, |
| 530 | + "status": { "type": "string", "example": "COMPLETED" }, |
| 531 | + "title": { "type": "string", "example": "낙서 타입 커미션" }, |
| 532 | + "totalPrice": { "type": "integer", "example": 50000 }, |
| 533 | + "completedAt": { "type": "string", "format": "date-time", "example": "2025-06-04T15:30:00.000Z" }, |
| 534 | + "thumbnailImageUrl": { |
| 535 | + "type": "string", |
| 536 | + "nullable": true, |
| 537 | + "example": "https://example.com/commission-thumbnail.jpg" |
| 538 | + }, |
| 539 | + "artist": { |
| 540 | + "type": "object", |
| 541 | + "properties": { |
| 542 | + "id": { "type": "integer", "example": 1 }, |
| 543 | + "nickname": { "type": "string", "example": "키르" } |
| 544 | + } |
| 545 | + }, |
| 546 | + "commission": { |
| 547 | + "type": "object", |
| 548 | + "properties": { |
| 549 | + "id": { "type": "integer", "example": 12 } |
| 550 | + } |
| 551 | + } |
| 552 | + } |
| 553 | + } |
| 554 | + }, |
| 555 | + "pagination": { |
| 556 | + "type": "object", |
| 557 | + "properties": { |
| 558 | + "page": { "type": "integer", "example": 1 }, |
| 559 | + "limit": { "type": "integer", "example": 10 }, |
| 560 | + "totalCount": { "type": "integer", "example": 25 }, |
| 561 | + "totalPages": { "type": "integer", "example": 3 } |
| 562 | + } |
| 563 | + } |
| 564 | + } |
| 565 | + } |
| 566 | + } |
| 567 | + } |
| 568 | + } |
| 569 | + } |
| 570 | + } |
| 571 | + } |
| 572 | + } |
467 | 573 | } |
468 | 574 | }, |
469 | 575 | "components": { |
|
0 commit comments