Sign in
Letters

편지 최종 저장 및 링크 생성 api

최종 편지 데이터를 DB에 저장하고 고유 ID를 반환합니다. 발신자 식별을 위해 인증 미들웨어가 적용됩니다.

post/api/letters

Request

  • Base URL: http://54.180.159.211:8080
  • URL: http://54.180.159.211:8080/api/letters
  • Auth: cookieAuth (a scheme the document does not define)

Request body

sender_idinteger nullable

로그인한 사용자의 경우 유저 고유 ID (비회원은 null)

sender_namestring required

보내는 사람 이름

receiver_namestring required

받는 사람 이름

categorystring required

편지 카테고리

contentstring required

최종 편지 내용 (AI가 다듬어준 문구 포함)

themenumber required

선택한 편지 테마 번호 (1~5)

passwordstring nullable

발신자가 설정한 비밀번호

Example request

{
  "sender_id": 1,
  "sender_name": "정화",
  "receiver_name": "민수",
  "category": "생일",
  "content": "민수야, 생일 정말 축하해! 맛있는 거 많이 먹어!.",
  "theme": 1,
  "password": "1111"
}

Response

편지 저장 및 링크 생성 성공

successboolean
metaobject nullable
errorobject nullable

Example response

{
  "success": true,
  "data": {
    "letter_id": "V1StG_K9_D9W9SpgS8",
    "published_at": "2026-04-28T14:41:59Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.