저장·리뷰 작성

작성 완료 (신규)

Changed on

완성도 판정(C4)을 충족하면 리뷰·티켓·매장 집계까지 같은 트랜잭션에서 나간다 (TX-1). draft: true면 판정을 충족해도 확정하지 않는다 — 단계 사이의 중간 저장용이다.

post/v1/saves

Request

  • Base URL: http://localhost:8080/api
  • URL: http://localhost:8080/api/v1/saves
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required
Example:6f7d9c8e-4b2a-4f1e-9c3d-2a7b5e8f1c04

재시도가 중복을 만들지 않게 하는 키. 앞뒤 공백은 제거되고, 최대 100자다 (규약 §9-1)

Request body

placeIdstring nullable
photoAssetIdsstring[]
companionTagIdsstring[]
positivePointTagIdsstring[]
ratinginteger nullable
contentstring nullable
draftboolean

중간 저장이면 true — 값이 다 차도 리뷰·티켓이 나가지 않는다. 생략하면 작성 완료(false)

groupIdstring nullable

이 리뷰를 시작한 그룹. 리뷰가 성립하면 같은 트랜잭션에서 그 그룹에 공유한다 (TMT-423). 멤버가 아니거나 없는 그룹이면 리뷰만 만들고 공유는 건너뛴다

Example request

{
  "groupId": "group_11"
}

Response

Created

Changes

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • breaking

      removed the success response with the status

    • info

      added the success response with the status