- v0
- v1
- 인증
- 유저
- 이미지
- 이야기
랜덤 이야기들 가져오기
Develop Env
Develop Env
GET
/apis/v1/posts/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/posts/random?existingIds=""'
Responses
🟢200🟢 랜덤 이야기들 가져오기 성공
application/json
Body
payload
array[object (Post) {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-01-14 08:41:52