단일 이야기 생성

Request

Body Params application/json

title

string

required

게시글 제목

summary

string

required

게시글 요약

content

string

required

게시글 내용

thumbnailPath

string | null

optional

게시글 썸네일 이미지 경로

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://localhost:9050/apis/v1/posts' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "Postman 게시글",
    "summary": "Postman 게시글 요약",
    "content": "Postman 게시글 요약입니다.\n대충 아무말 작성",
    "category": "GENERAL_KNOWLEDGE"
}'

Responses

🟢201🟢 이야기 생성 성공

application/json

Body

toast

object (Toast)

required

title

string

required

프론트에서 렌더링할 토스트 메시지 제목

description

string

required

프론트에서 렌더링할 토스트 메시지 내용

payload

object (Post)

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

{
  "toast": {
    "title": "게시글 작성 완료",
    "description": "게시글을 작성했습니다.\n메인 페이지로 이동합니다!"
  },
  "payload": {
    "id": "af27e410-b35a-4e9b-8e63-fcadffc6a0a6",
    "createdAt": "2025-01-12T01:05:35.042Z",
    "updatedAt": "2025-01-12T01:05:35.042Z",
    "deletedAt": null,
    "title": "Postman 게시글",
    "summary": "Postman 게시글 요약",
    "content": "Postman 게시글 요약입니다.\n대충 아무말 작성",
    "thumbnailPath": null,
    "category": "GENERAL_KNOWLEDGE",
    "userId": "00000000-0000-0000-0000-000000000000"
  }
}

🟠400🔴 유효성 검사 실패

🟠403🔴 권한없음

🟠409🔴 중복된 요청