story-dict
  1. 이야기
story-dict
  • v0
    • ping-pong
      GET
  • v1
    • 인증
      • 로그아웃
    • 유저
      • 로그인한 유저 정보 요청
      • 회원가입
    • 이미지
      • 미리 서명된 URL
      • 이미지 이동
    • 이야기
      • 리액션
        • 이야기의 리액션 생성
        • 이야기의 리액션 수정
        • 이야기의 리액션 제거
      • 댓글
        • 리액션
          • 이야기의 댓글의 리액션 생성
          • 이야기의 댓글의 리액션 수정
          • 이야기의 댓글의 리액션 삭제
        • 이야기의 댓글 생성
        • 이야기의 모든 댓글들 가져오기
        • 이야기의 댓글 수정
        • 이야기의 댓글 삭제
      • 모든 이야기들 가져오기
        GET
      • 랜덤 이야기들 가져오기
        GET
      • 단일 이야기 가져오기
        GET
      • 제목으로 단일 이야기 가져오기
        GET
      • 키워드로 이야기들 검색
        GET
      • 카테고리로 이야기들 가져오기
        GET
      • 단일 이야기 수정
        PATCH
      • 단일 이야기 삭제
        DELETE
      • 이야기 제목 중복 검사
        POST
      • 단일 이야기 생성
        POST
  1. 이야기

랜덤 이야기들 가져오기

Develop Env
http://localhost:9050
Develop Env
http://localhost:9050
GET
/apis/v1/stories/random
랜덤한 이야기들을 가져오는데 부족한 부분이 많아 수정할 예정
1.
가져올 개수 지정
2.
GET 요청이라 params를 이용해서 현재 가지고 있는 이야기들의 식별자(existingIds)를 받는데 다른 방법 고민중

Request

Query Params
existingIds
string 
required
이미 가지고 있는 이야기들의 식별자 ( ,로 구분 )
Example:
""

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://localhost:9050/apis/v1/stories/random?existingIds=""'

Responses

🟢200🟢 랜덤 이야기들 가져오기 성공
application/json
Body
payload
array[object (Story) {10}] 
required
id
string 
required
이야기 식별자
createdAt
string 
required
생성 일자
Default:
CURRENT_TIMESTAMP
updatedAt
string 
required
수정 일자
deletedAt
string  | null 
optional
삭제 일자
title
string 
required
이야기 제목
summary
string 
required
이야기 요약
content
string 
required
이야기 내용
thumbnailPath
string  | null 
optional
이야기 썸네일 이미지 경로
category
enum<string> 
required
이야기 카테고리
Allowed values:
GENERAL_KNOWLEDGEETYMOLOGYPURE_KOREANQUOTATIONINFORMATIONNONSENSE
userId
string 
required
유저 식별자
Example
{
    "payload": [
        {
            "payload": [
                {
                    "id": "00000000-0000-0000-0000-340000000000",
                    "createdAt": "2025-01-09T10:56:16.226Z",
                    "updatedAt": "2025-01-09T10:56:16.226Z",
                    "deletedAt": null,
                    "title": "힐풀탭",
                    "summary": "운동화 뒤꿈치에 달린 작은 고리",
                    "content": "힐풀탭(Heel pull tab)은 운동화나 부츠의 뒤꿈치 부분에 달린 작은 고리입니다. `힐 루프(Heel loop)` 또는 `부트 루프(Boot loop)`라고도 불립니다.\n\n이 작은 고리는 신발을 신을 때 손가락을 걸어 쉽게 신발을 신을 수 있도록 도와주는 실용적인 디자인 요소입니다.\n\n특히 운동화나 부츠처럼 꼭 맞는 신발을 신을 때 유용하며, 신발 뒤축이 망가지는 것을 방지해주는 역할도 합니다.\n\n최근에는 실용성을 넘어 브랜드 로고나 디자인 요소를 추가하여 패션 아이템으로도 활용되고 있으며, 일부 브랜드에서는 이를 시그니처 디자인으로 발전시키고 있습니다.",
                    "thumbnailPath": null,
                    "category": "INFORMATION",
                    "userId": "00000000-0000-0000-0000-000000000000",
                    "reactions": []
                },
                {
                    "id": "00000000-0000-0000-0000-430000000000",
                    "createdAt": "2025-01-09T10:56:16.226Z",
                    "updatedAt": "2025-01-09T10:56:16.226Z",
                    "deletedAt": null,
                    "title": "지관",
                    "summary": "화장지나 포장지의 중심에 있는 종이 심",
                    "content": "지관(紙管)은 화장지, 포장지, 테이프 등의 중심에 있는 원통형 심입니다. `페이퍼 코어(Paper core)` 또는 `종이 심`이라고도 불립니다.\n\n지관은 여러 겹의 종이를 나선형으로 감아 만든 튜브 형태의 제품입니다. 겉으로는 단순해 보이지만, 제품의 무게를 지탱하고 모양을 유지하는 중요한 역할을 합니다.\n\n특히 화장지 지관의 경우, 적절한 강도를 유지하면서도 쉽게 분리될 수 있도록 설계되어 있습니다. 또한 재활용이 가능한 친환경 소재로 만들어져 환경 보호에도 기여합니다.\n\n산업용 지관은 더 견고하게 제작되어 중량물을 감는 용도로도 사용됩니다. 섬유, 필름, 금속박 등 다양한 산업 분야에서 활용되며, 때로는 방수 처리나 특수 코팅이 추가되기도 합니다.",
                    "thumbnailPath": null,
                    "category": "INFORMATION",
                    "userId": "00000000-0000-0000-0000-000000000000",
                    "reactions": []
                },
                {
                    "id": "00000000-0000-0000-0000-220000000000",
                    "createdAt": "2025-01-09T10:56:16.226Z",
                    "updatedAt": "2025-01-09T10:56:16.226Z",
                    "deletedAt": null,
                    "title": "옥춘당",
                    "summary": "제사상에 오르는 알록달록한 사탕",
                    "content": "옥춘당은 전통적으로 제사상이나 차례상에 올리는 알록달록한 색상의 한과 종류입니다.\n\n주로 하얀색, 분홍색, 노란색 등 다양한 색상으로 만들어지며, 쌀가루나 밀가루를 주원료로 하여 만든 전통 과자입니다.\n\n옥춘당이라는 이름의 유래는 `옥처럼 맑고 봄처럼 향기롭다`는 의미에서 비롯되었다고 합니다.\n\n현대에는 제사 문화가 간소화되면서 점차 찾아보기 힘들어졌지만, 여전히 일부 한과점이나 전통 시장에서 구할 수 있습니다.",
                    "thumbnailPath": null,
                    "category": "INFORMATION",
                    "userId": "00000000-0000-0000-0000-000000000000",
                    "reactions": []
                },
                {
                    "id": "00000000-0000-0000-0000-100000000000",
                    "createdAt": "2025-01-09T10:56:16.226Z",
                    "updatedAt": "2025-01-09T10:56:16.226Z",
                    "deletedAt": null,
                    "title": "플라톤",
                    "summary": "플라톤은 \"plat\"(평평한)에서 유래된 말",
                    "content": "그리스 철학자 플라톤의 원래 이름은 `아리스토클레스`입니다.\n어깨가 넓고 벌어져서 `plat`하다, 플라톤이라는 이름을 갖게 되었습니다.",
                    "thumbnailPath": null,
                    "category": "ETYMOLOGY",
                    "userId": "00000000-0000-0000-0000-000000000000",
                    "reactions": []
                }
            ]
        }
    ]
}
🟠400🔴 유효성 검사 실패
Modified at 2025-04-22 23:35:50
Previous
모든 이야기들 가져오기
Next
단일 이야기 가져오기
Built with