{"info":{"_postman_id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","name":"Tripture API Documentation","description":"

📄 Tripture 개발팀 API 명세서

VER1.1(2024.07.26)
\n
- 이미지 URL ${cloud.aws.url}로 뜨는 문제 해결
  \n
- 프로필관련 응답메시지 추가
  \n
- 프로필(회원 수정) 요청메시지 formdata로 변경 및 PUT -> POST로 변경
  \n
- 회원 로그인 API 성공 시 반환값 string으로 변경
  \n
\n
VER1.2(2024.08.06)
\n
- 마이페이지에서 작성한 댓글, 작성한 게시글, 내가 저장한 챌린지 / 포인트 상점에서 상품 리스트 페이징 구현 완료
\n
VER1.3(2024.08.07)
\n
- 카카오페이 결제 API 구현
  \n
- 로그인 API 자동 로그인 여부 추가 (세션, 쿠키)
  \n
\n
VER1.4(2024.08.13)
\n
- 페이징 관련 API 전체에 totalPages (전체 페이지 수)를 같이 리턴하도록 수정
  \n
- 검색엔진 구현 완료 - 포토 챌린지 검색, 상품 검색
  \n
- Redis - 이메일 인증, 조회수 구현 완료
  \n
\n
VER1.5(2024.08.25)
\n
- /challenge/area_list
  /challenge/TopSurroundingChallenge
  /item/buy
  \n
- 위 API를 GET -> POST로 수정
  \n
\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"📄 Tripture 개발팀 API 명세서","slug":"tripture-api"}],"owner":"30136265","collectionId":"0c1bae46-b123-49c5-a782-f5535d2a7daa","publishedId":"2sA3kYifMY","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-07-26T07:06:10.000Z"},"item":[{"name":"회원가입 및 로그인","item":[{"name":"자체 회원가입","id":"3e8132a8-2c7b-4c0d-9ff6-a5aec1793b9f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"loginEmail","value":"logintest2@gmail.com","type":"text"},{"key":"loginPw","value":"logintest","type":"text"},{"key":"nickname","value":"test","type":"text"},{"key":"loginType","type":"text","value":"SELF"},{"key":"file","type":"file","value":null},{"key":"emailAuthCheck","value":"true","type":"text"}]},"url":"http://localhost:8080/login/new","description":"

form-data 형식으로 요청
\n
해당 API는 앱 자체 회원 가입을 위한 API 입니다! loginType에는 SELF로 넣어주시면 될 것 같습니다.
\n
회원가입 성공 시에는 \"User register success\" 값이 반환됩니다.
\n
중복 닉네임으로 가입할 시 오류 메세지가 반환됩니다.
\n
자체 회원 가입을 했던 이메일로 다시 가입을 한다면 오류가 반환됩니다.
\n
file 부분이 body에 추가됐습니다! 해당 부분은 사용자가 file을 올리지 않았을 경우 빈값으로 넘겨주시고, 파일을 올렸을 경우에는 값을 채워 보내주시면 됩니다.
\n
담당자 - 최지민
\n

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","name":"Tripture API Documentation","type":"collection"}},"urlObject":{"protocol":"http","port":"8080","path":["login","new"],"host":["localhost"],"query":[{"disabled":true,"key":"","value":""}],"variable":[]}},"response":[{"id":"d7a6a055-92ba-4b86-bc82-b7ac016bb18c","name":"자체 회원가입","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"loginEmail","value":"logintest@gmail.com","type":"text"},{"key":"loginPw","value":"logintest","type":"text"},{"key":"nickname","value":"test","type":"text"},{"key":"loginType","type":"text","value":"SELF"},{"key":"file","type":"file","value":null},{"key":"emailAuthCheck","value":"true","type":"text"}]},"url":{"raw":"http://localhost:8080/login/new","protocol":"http","host":["localhost"],"port":"8080","path":["login","new"],"query":[{"key":"","value":"","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Set-Cookie","value":"JSESSIONID=66A919D7208FEF19DB4A737D8A37C570; Path=/; HttpOnly"},{"key":"Content-Type","value":"text/plain;charset=UTF-8"},{"key":"Content-Length","value":"21"},{"key":"Date","value":"Tue, 20 Aug 2024 14:40:06 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"User register success"},{"id":"dd48e6f7-7160-42ca-812b-3777cd712c07","name":"자체 회원가입 (이메일 인증 X)","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"loginEmail","value":"logintest@gmail.com","type":"text"},{"key":"loginPw","value":"logintest","type":"text"},{"key":"nickname","value":"test","type":"text"},{"key":"loginType","type":"text","value":"SELF"},{"key":"file","type":"file","src":"postman-cloud:///1ef3d261-b830-4e40-b2e5-d3b22b4d4647"},{"key":"emailAuthCheck","value":"false","type":"text"}]},"url":{"raw":"http://localhost:8080/login/new","protocol":"http","host":["localhost"],"port":"8080","path":["login","new"],"query":[{"key":"","value":"","disabled":true}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 20 Aug 2024 14:39:28 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"이메일 인증이 되지 않은 이메일입니다.\"\n}"},{"id":"3eeb0bc1-5575-4722-a752-57de1547e883","name":"자체 회원가입 (이미 가입한 회원일 경우)","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"loginEmail","value":"logintest@gmail.com","type":"text"},{"key":"loginPw","value":"logintest","type":"text"},{"key":"nickname","value":"test","type":"text"},{"key":"loginType","type":"text","value":"SELF"},{"key":"file","type":"file","value":null},{"key":"emailAuthCheck","value":"true","type":"text"}]},"url":{"raw":"http://localhost:8080/login/new","protocol":"http","host":["localhost"],"port":"8080","path":["login","new"],"query":[{"key":"","value":"","disabled":true}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 20 Aug 2024 14:40:19 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"이미 사용 중인 이메일입니다.\"\n}"},{"id":"4d18ec74-8aaf-4a21-b77d-191431997b06","name":"자체 회원가입 (중복된 닉네임 오류)","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"loginEmail","value":"logintest2@gmail.com","type":"text"},{"key":"loginPw","value":"logintest","type":"text"},{"key":"nickname","value":"test","type":"text"},{"key":"loginType","type":"text","value":"SELF"},{"key":"file","type":"file","value":null},{"key":"emailAuthCheck","value":"true","type":"text"}]},"url":{"raw":"http://localhost:8080/login/new","protocol":"http","host":["localhost"],"port":"8080","path":["login","new"],"query":[{"key":"","value":"","disabled":true}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 20 Aug 2024 14:41:51 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"이미 사용 중인 닉네임입니다.\"\n}"}],"_postman_id":"3e8132a8-2c7b-4c0d-9ff6-a5aec1793b9f"},{"name":"이메일 인증","id":"c621f1bd-06c5-42de-a915-1814e3d481af","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"wlco1323@naver.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/login/mailSend","description":"

이메일 인증 버튼 클릭 시에 사용자에게 인증 번호가 전송되는 API 입니다.
\n
사용자가 입력한 이메일을 넣어 요청해 주시면 됩니다.
\n
실제 이메일이 전송되므로 실행 시에 본인의 이메일이나 현재 적힌 이메일로만 실행 부탁드립니다!
\n
담당자 - 최지민
\n

인증번호 확인 시에 사용되는 API 입니다.
\n
반환값
\n
- 인증번호가 일치할 경우 : true
  \n
- 일치하지 않을 경우 : 400 에러와 함께 메시지가 반환됩니다.
  \n
- 이메일 인증 유효시간이 지났을 경우 (10분) : 400 에러와 함께 메시지가 반환됩니다.
  \n
\n
API 요청 시에는 사용자 email과 입력한 인증번호를 보내주시면 됩니다.
\n
담당자 - 최지민
\n

자체 회원 가입 회원이 로그인 시 사용되는 API 입니다.
\n
로그인 성공 시 \"User login success\" 가 전송됩니다.
\n
존재하지 않는 이메일일 경우 오류 메세지가 반환됩니다.
\n
이메일과 비밀번호가 일치하지 않을 경우 또한 오류 메세지가 반환됩니다.
\n
자동 로그인 구현이 완료되어, path 값으로 사용자가 자동 로그인을 체크 했을 시에는 true, 체크하지 않았을 경우에는 false를 넘겨주시면 됩니다.
\n
true가 체크 되었을 경우에는 쿠키가 생성되고 해당 쿠키는 90일 동안 유효합니다.
\n
담당자 - 최지민
\n

자동 로그인을 한 사용자가 로그인이 만료 됐을 경우 다른 API에 접근했을 때 나타나는 오류입니다.
\n
로그인과 회원가입을 제외한 전체 API에서 로그인이 만료됐을 시 해당 오류가 발생합니다.
\n
담당자 - 최지민
\n

비밀번호 찾기 클릭 시 사용되는 API 입니다.
\n
이메일 인증이 된 이메일, 바꿀 비밀번호를 보내주시면 됩니다.
\n
인증이 된 비밀번호지만, 이메일이 존재하지 않을 경우 404 에러와 함께 메세지가 반환됩니다.
\n
담당자 - 최지민
\n

purchaseId는 상품ID입니다.
\n
itemName은 아이템명, itemPosition은 사용처입니다.
\n
담당자 - 장다연
\n

purchaseId는 상품ID입니다.
\n
itemName은 아이템명, itemPosition은 사용처입니다.
\n
담당자 - 장다연
\n

마이페이지_티켓보관함에서 \"사용하기\" 버튼을 위한 api입니다.
\n
성공 시 \"redirection request\" 문자열이 반환됩니다. 리다이렉션을 요청합니다.
\n
실패 시 \"이미 사용한 아이템입니다.\" 를 반환합니다.
\n
담당자-장다연
\n

마이페이지_티켓보관함_티켓상세정보를 위한 api입니다.
\n
상품 사용유무는 purchaseCheck(true:사용후,false:사용전)에서 확인할 수 있습니다.
\n
상품구매개수는 purchaseCount, itemPosition은 상품사용처, itemName은 상품명, itemImgName은 상품이미지주소를 뜻합니다.
\n
담당자-장다연
\n

포인트 상점 페이지에서 상품의 전체 목록을 조회할 때 쓰는 API 입니다.
\n
- itemId : 상품 고유 Id
  \n
- itemImgName : 상품 이미지 Url
  \n
- itemPrice : 상품 가격
  \n
- itemName : 상품 이름
  \n
- itemPosition : 상품 사용 가능한 장소 ( 해당 값의 경우 상품 조회 API 설명 한 번 참고해 주시면 감사하겠습니다! )
  \n
- itemStock : 현재 남은 상품 수량
  \n
\n
응답값에 itemStock이 포함되어 있는데, 해당 값이 0인 상품은 흐리게 처리해 들어가지 못하도록 막아주시면 좋을 것 같습니다..!!
\n
~~우선 페이징 처리 없이 모든 리스트를 불러오도록 구현되었습니다.~~
\n
- item 5개씩 페이징 구현 완료했습니다.
  \n
- 기본은 itemViewCount 정렬입니다.
  \n
- 시작page는 0부터이고, criteria는 정렬 기준입니다.
  \n
  - 최신순 : itemDate
    \n
  - 조회순 : itemViewCount
    \n
  \n
- Url에 page와 criteria 데이터를 전달해주셔야합니다.
  \n
- page, criteria 디폴트값은 0, itemDate 입니다.
  \n
- totalPages는 전체 페이지 수입니다.
  \n
- 담당자 - 장다연
  \n
\n
담당자 - 최지민
\n

path에 itemId(해당 상품 Id) 값을 같이 넘겨주시면 해당 상품의 상세 정보를 반환해주는 API 입니다.
\n
- itemId : 해당 상품 고유 Id 값
  \n
- itemName : 상품 이름
  \n
- itemDescription : 상품 설명
  \n
- itemPrice : 상품 가격
  \n
- itemPosition : 상품 사용할 수 있는 위치
  \n
\n
itemPosition의 경우 해당 상품이 사용 가능한 위치를 보여줘야 해서 일단 넣어뒀습니다..! 위치 정보 때문에 API 계속 호출하기 부담스러우시면 저희가 DB에 주소 정보 넣는 방법도 괜찮을 것 같습니다!
\n
실패 시에는 메세지와 함께 404 에러가 반환됩니다.
\n
담당자 - 최지민
\n

상품 상세 페이지에서 상품 결제 클릭 시에 실행되는 API 입니다
\n
상품 Id랑 유저가 상품을 몇 개 구매했는지 넘겨주시면
\n
- needPoint : 사용할 포인트 = 상품 가격
  \n
- havePoint : 사용자가 가진 포인트
  \n
- stockCount : 상품 구매 개수
  \n
\n
가 반환됩니다!
\n
상품을 보유한 재고보다 더 많이 구매 시, 혹은 포인트 부족 시 400에러와 함께 메세지가 반환됩니다.
\n
담당자 - 장다연
\n

카카오페이 결제 버튼을 누를 시에 호출되는 API입니다.
\n
request 형식은
price : 제품의 total price
amount : 제품의 구매 개수
itemId : 제품의 Id
usePoint : 유저가 사용한 point
\n
price의 경우 상품 구매 API를 앞에서 호출했을 때 최종 결제 금액이 반환되도록 해두었습니다. 그 금액을 그대로 보내주시면 될 것 같습니다.
\n
usePoint의 경우 사용자가 포인트를 사용하지 않았을 경우에는 0으로 보내주시면 될 것 같습니다.
\n
사용 방법
\n
- response message의 mobile-url을 그대로 연결해주시고, 결제 완료할 시에 \"kakaoPay success\"와 200 상태가 전달됩니다.
  \n
- 예외처리
  \n
  - 포인트가 유저가 가진 포인트보다 많이 사용하는 경우에는
    포인트가 부족합니다.
    라는 메세지와 함께 400에러가 발생합니다.
    \n
  - 카카오페이 결제 후 카카오페이 서버에서 응답값이 오지 않았을 경우에는
    카카오페이 결제 오류
    라는 메세지와 함께 400에러가 발생합니다.
    \n
  - 카카오페이 결제 승인 절차에서 사용자가 취소했을 경우에는 \"사용자가 결제 취소했습니다.\"와 400, 결제 실패했을 경우에는 \"사용자가 결제 실패했습니다.\"와 400 에러가 뜹니다.
    \n
  \n
\n
담당자 - 장다연, 최지민
\n

request 형식은
price : 제품의 total price
amount : 제품의 구매 개수
itemId : 제품의 Id
usePoint : 유저가 사용한 point (= price*amount)
\n
\"상품 구매\" api를 통해 결제 가능 여부 판단하기에 여기서는 결제만 진행합니다.
\n
담당자 - 장다연
\n

item 5개씩 페이징 구현 완료했습니다.
\n
시작page는 0부터(기본)이고, criteria는 정렬 기준입니다.
\n
기본은 itemViewCount 정렬입니다.
\n
- 최신순 : itemDate
  \n
- 조회순 : itemViewCount
  \n
\n
Url에 page와 criteria 데이터를 전달해주셔야합니다.
\n
searchOne은 검색어를 utf-8로 인코딩해서 전달해주세요.
\n
searchOne은 공백일 경우 API 호출을 막아주세요!
\n
totalPages는 전체 페이지 수를 뜻합니다.
\n
담당자 -장다연
\n

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","name":"Tripture API Documentation","type":"collection"}},"urlObject":{"protocol":"http","port":"8080","path":["item","search"],"host":["localhost"],"query":[{"key":"searchOne","value":"%20%EB%8C%80%EB%91%94%EC%82%B0"},{"key":"page","value":"0"},{"key":"criteria","value":"itemDate"}],"variable":[]}},"response":[{"id":"5898bd2a-ae0a-4e5b-b812-48f65ff13f95","name":"상품 검색(빈 검색어 입력 시)","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"http://localhost:8080/item/search?searchOne=&page=0&criteria=itemViewCount","protocol":"http","host":["localhost"],"port":"8080","path":["item","search"],"query":[{"key":"searchOne","value":""},{"key":"page","value":"0"},{"key":"criteria","value":"itemViewCount"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 12 Aug 2024 17:14:15 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"검색어는 필수입니다\"\n}"},{"id":"7061de92-42bc-47fc-a795-d820a193f31d","name":"상품 검색","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"http://localhost:8080/item/search?searchOne=%20%EB%8C%80%EB%91%94%EC%82%B0&page=0&criteria=itemViewCount","protocol":"http","host":["localhost"],"port":"8080","path":["item","search"],"query":[{"key":"searchOne","value":"%20%EB%8C%80%EB%91%94%EC%82%B0"},{"key":"page","value":"0"},{"key":"criteria","value":"itemViewCount"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Set-Cookie","value":"JSESSIONID=AC36819CB820620A4E0E2361FD680D80; Path=/; HttpOnly"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sat, 17 Aug 2024 06:52:57 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"totalPages\": 1,\n \"searchResponseList\": [\n {\n \"itemId\": 1,\n \"itemImgName\": \"https://tripture.s3.ap-northeast-2.amazonaws.com/file/be_item.png\",\n \"itemName\": \"Item 1\",\n \"itemPosition\": \"A1\",\n \"itemPrice\": 1000\n }\n ]\n}"},{"id":"4c0dd3c4-ec74-4e46-a735-68a4f85abda8","name":"상품 검색 (page, criteria 기본)","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"http://localhost:8080/item/search?searchOne=%20%EB%8C%80%EB%91%94%EC%82%B0","protocol":"http","host":["localhost"],"port":"8080","path":["item","search"],"query":[{"key":"searchOne","value":"%20%EB%8C%80%EB%91%94%EC%82%B0"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sat, 17 Aug 2024 06:53:18 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"totalPages\": 1,\n \"searchResponseList\": [\n {\n \"itemId\": 1,\n \"itemImgName\": \"https://tripture.s3.ap-northeast-2.amazonaws.com/file/be_item.png\",\n \"itemName\": \"Item 1\",\n \"itemPosition\": \"A1\",\n \"itemPrice\": 1000\n }\n ]\n}"}],"_postman_id":"40ca9a54-f58e-42d9-bdc2-b514649c080d"}],"id":"d1a9580b-5a43-4305-94a5-83d58a836f1a","_postman_id":"d1a9580b-5a43-4305-94a5-83d58a836f1a","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","name":"Tripture API Documentation","type":"collection"}}},{"name":"마이페이지","item":[{"name":"포인트","item":[{"name":"포인트 잔액 조회","id":"e8602681-fb48-4bd7-bc15-41a266af9126","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8080/profile/point","description":"

사용자가 가진 전체 포인트 조회 시에 사용되는 API 입니다.
\n
담당자 - 최지민
\n

페이징은 5개씩되도록 구현했습니다. 수정이 필요하면 말씀해주세요!
\n
request값
\n
- startDate : 기간 조회에서 시작일
  \n
- endDate : 기간 조회에서 종료일
  \n
- page : 몇 번째 페이지(페이지는 0부터 시작됩니다.)
  \n
\n
response값
\n
- totalPages : 총 페이지 수
  \n
- pointDtos:
  \n
  - pointTitle : 포인트 사용 혹은 적립한 내역의 제목을 뜻합니다.
    \n
  - pointDate : 포인트 사용 혹은 적립일
    \n
  - pointChange : 포인트 변화값
    \n
  \n
\n
담당자 - 장다연
\n

최신순으로 정렬되어 제공합니다.
\n
contentId만 주어집니다. 이 contentId는 관광openApi에서 contentId를 이용하여 검색 가능합니다. 검색해서 필요한 관광지 정보를 불러와 이용하세요.
\n
~~우선 페이징 구현없이 전체 리스트를 리턴했습니다.~~
\n
- 페이징 구현했습니다. 8월 7일 기준 디자인이 관광지 2개씩 가져오는 것 같아, 우선 페이징 2개씩 구현했습니다.
  \n
- page index는 0부터 시작입니다.
  \n
- totalPages는 총 페이지 수입니다.
  \n
- page 전달 없을 시 0을 기본값으로 호출합니다.
  \n
- 담당자 - 장다연
  \n
\n
담당자-장다연
\n

최신순으로 정렬되어 제공합니다.
\n
postId는 사진 누를시 전달해야하는 사용자가 작성한 포토챌린지의 id입니다.
\n
postImgName은 포토챌린지 사진의 주소입니다.
\n
~~우선 페이징 구현없이 전체 리스트를 리턴했습니다.~~
\n
- 페이징 구현했습니다. 8월 7일 기준 챌린지를 12개가 아닌 9개로 가져오는 것 같아 우선 9개로 구현했습니다.
  \n
- page index는 0부터 시작입니다. page입력이 없으면 디폴트값이 0입니다.
  \n
- totalPages는 전체 페이지 수입니다.
  \n
- 담당자 - 장다연
  \n
\n
담당자-장다연
\n

마이페이지_나의 챌린지에서 챌린지 레벨을 조회하기 위한 api입니다. 레벨명이 반환됩니다.
\n
담당자-장다연
\n

내가 작성한 게시글을 모두 조회하는 API
\n
날짜순으로 정렬된 데이터입니다.
\n
~~페이징 구현을 안하고 전체를 조회하였습니다.~~
\n
- 페이징 구현 완료했고 9개씩 최신순으로 가져오도록 구현했습니다.
  \n
- 인덱스는 0부터입니다. page 변수 생략시 page=0인 데이터가 제공됩니다.
  \n
- totalPages는 전체 페이지 수입니다.
  \n
- 담당자 - 장다연
  \n
\n
담당자-장다연
\n

내가 작성한 댓글을 모두 조회하는 API
\n
commentContent는 댓글 내용 / commentId는 댓글ID / postId는 댓글작성한포토챌린지글의ID / postContent는 댓글작성한포토챌린지글 내용 / commentCalculatedDate는 날짜
\n
commentCalculatedDate는 이미 \"2일전 작성\"과 같이 변환작업이 끝난 작성일자입니다. 그대로 쓰시면 됩니다.
\n
최신순으로 정렬되어있습니다.
\n
~~우선 페이징 구현없이 전체 데이터를 가져왔습니다.~~
\n
- 2개씩 최신순으로 페이징 구현 완료했습니다.
  \n
- 인덱싱은 0부터 시작입니다. page 전달안할 시 디폴트는 0으로 호출됩니다.
  \n
- totalPages는 전체 페이지 수입니다.
  \n
  - 담당자 - 장다연
  \n
\n
담당자 - 장다연
\n

지역 구분
\n
- inc : 인천/경기
  \n
- seo : 서울
  \n
- jeon : 호남
  \n
- gang : 강원
  \n
- chung : 충청
  \n
- gyeong : 영남
  \n
- je : 제주도
  \n
\n
각각 0번 인덱스는 나의 챌린지 수, 1번 인덱스는 전체 챌린지 수를 뜻합니다.
\n
담당자 - 장다연
\n

마이페이지_개인정보 수정 페이지에 쓰이는 api입니다.
\n
자체로그인일 경우 loginPw에 아무 값이나 보내도 상괸없습니다.
\n
닉네임과 비밀번호 유효성 검사를 진행하지 않습니다.
\n
성공 시, \"redirection request\" 문자열과 303(리다이렉트 요청)이 반환됩니다.
\n
(담당자 - 장다연)
\n

8월 21일 설명 추가

profileNickname, file, loginPw 값 모두 전달해주시는데, loginPw는 어차피 수정안되니 아무값 넣어서 보내주셔도 됩니다. profileNickname과 file은 수정되었으면 수정된 값, 수정되지 않았으면 기존 값 그대로 전달해주시면 됩니다.

마이페이지_개인정보 수정 페이지의 수정 폼 api 입니다.
\n
ProfileImgName은 사진이 없을 경우는 \"default\"가, 사진이 있을 경우는 url 주소가 반환됩니다. default가 반환되었을 때 default 이미지가 뜨도록 구현해야 합니다.
\n
(담당자 - 장다연)
\n

담당자 - 장다연

담당자 - 장다연

마이페이지 상단에 필요한 프로필이름, 사진, 이메일을 제공하는 api입니다.
\n
ProfileImgName은 사진이 없을 경우는 \"default\"가, 사진이 있을 경우는 url 주소가 반환됩니다. default가 반환되었을 때 default 이미지가 뜨도록 구현해야 합니다.
\n
(담당자 - 장다연)
\n

해당 게시글의 id(postId)와 page 정보를 입력해주시면 됩니다.
\n
page의 인덱스는 0번부터 시작되고, 디자인 피그마를 참고해 우선 4개씩 페이징되도록 구현했습니다. 나중에 수정이 필요하시면 말씀해주세요!
\n
- totalPages는 전체 페이지 수입니다.
\n
신고된 댓글은 차단되어야 해서, 구분할 수 있는 필드를 추가했습니다.
blockChk : false -> 차단되지 않은 댓글
blockChk: true -> 차단된 댓글
\n
담당자 - 장다연
\n

댓글 작성 시에 사용되는 API 입니다.
\n
request의 경우
groupId : 해당 댓글이 대댓글일 경우에 대댓글을 달려고 하는 댓글Id를 넣어주시면 됩니다. 만약 대댓글이 아닐 경우에는 0을 보내주시면 될 것 같습니다.
\n
postId : 게시물의 Id입니다.
commentContent : 댓글 내용입니다.
\n
존재하지 않는 게시물에 작성하려고 할 때, 404에러와 함께 메세지가 반환됩니다.
\n
담당자 - 최지민
\n

댓글 삭제 시 사용되는 API입니다.
\n
대댓글이 포함된 댓글은 대댓글도 같이 삭제됩니다.
\n
commentId에는 삭제될 댓글의 Id를 넣어주시면 됩니다.
\n
댓글이 존재하지 않을 경우에는 메세지와 함께 404 에러가 반환됩니다.
\n
담당자 - 최지민
\n

댓글에서 대댓글을 조회하는 API입니다.
\n
'댓글 더보기' 와 같은 버튼을 클릭했을 때 호출됩니다.
\n
groupId에는 url에 상위 댓글의 Id를 넘겨주시기만 하면 됩니다.
\n
신고된 댓글은 차단되어야 해서, 구분할 수 있는 필드를 추가했습니다.
blockChk : false -> 차단되지 않은 댓글
blockChk: true -> 차단된 댓글
\n
담당자 - 최지민
\n

커뮤니티 댓글 API입니다.

\n","_postman_id":"4b0719a6-a0c5-4b81-8441-3ca5957f8093","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","name":"Tripture API Documentation","type":"collection"}}},{"name":"포토챌린지","item":[{"name":"게시물 조회","id":"615d0d8a-6aed-4359-a7d4-9215a0605328","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8080/post/1","description":"

커뮤니티에서 포토챌린지 게시물을 조회할 때 사용되는 API입니다.
\n
1 부분에 게시물Id만 같이 요청해주시면 됩니다.
\n
profileId : 혹시 프로필 타고 들어갈 일이 생길까봐 우선 전송해뒀습니다..!
nickname : 회원 닉네임
level : 포토챌린지 레벨
imgUrl : 포토챌린지 사진
postContent : 포토챌린지 내용
postLikeCount : 포토챌린지 좋아요 수
contentId : 해당 관광지에 관한 상세정보를 띄워야 하는 것 같아서 공공API 조회를 위한 contentId를 같이 넘겼습니다! 예시에는 content1로 되어있지만, 추후 저장할 시에는 공공API에서 사용되는 contentId로 저장됩니다!
isMyPost : 사용자 본인의 게시물인지 표시하는 응답값입니다. 본인의 게시물일 경우 true, 아닐 경우 false가 반환됩니다.
isSaveBookmark : 사용자가 해당 게시물을 저장했는지 아닌지 표시하는 응답값입니다. 저장한 게시물일 경우 true, 아닐 경우 false가 반환됩니다.
isLike : 사용자가 해당 게시물에 좋아요를 눌렀는지 표시하는 응답값입니다. 좋아요를 눌렀을 경우 true, 누르지 않았을 경우 false가 반환됩니다.
\n
존재하지 않는 포토챌린지를 조회할 경우 메세지와 함께 404에러가 반환됩니다.
\n
담당자 - 최지민
\n

포토챌린지 수정 시 사용되는 API입니다.
\n
사용자가 사진 수정을 하지 않을 경우에는 file에 빈값을 보내주시면 됩니다.
-> 사진 수정이 없을 경우에도 빈값으로 꼭 file을 포함해서 보내주세요!
\n
포토챌린지 수정을 성공했을 경우에는 메세지가 반환됩니다. ( Post modification successful )
-> 303 리턴하는 것이 더 편하면 말씀해주시면 303 리턴으로 바꾸겠습니다..!
\n
존재하지 않는 포토챌린지를 수정할 경우 메세지와 함께 404 에러가 반환됩니다.
\n
담당자 - 최지민
\n

포토챌린지 삭제 시에 사용되는 API입니다.
\n
1 부분에 삭제되는 포토챌린지 게시물의 Id만 넣어서 요청해 주시면 됩니다.
\n
존재하지 않는 포토챌린지 삭제 시 메세지와 함께 404 에러가 반환됩니다.
\n
담당자 - 최지민
\n
포인트가 부족해서 삭제안될 경우 can't delete 반환
\n
성공시에는 successful in deleteing 반환
\n
수정자 - 장다연
\n

포토챌린지를 북마크 저장 시에 사용되는 API 입니다.
\n
북마크 삭제를 어떤 식으로 하는지 나와있지 않아 우선 같은 api를 사용하시고,
만약 저장된 북마크라면 삭제되도록, 저장되지 않은 북마크라면 저장되도록 만들었습니다.
저장되어 있던 챌린지를 다시 저장하기 클릭 시 -> Bookmark deletion successful
저장되어 있지 않던 챌린지를 저장하기 클릭 시 ->
Bookmark Save Successful
\n
챌린지를 조회하는 API를 사용시에 북마크 저장 여부를 같이 전달 드리겠습니다.
사용자가 저장한 챌린지일 경우 '저장한 챌린지' 를 텍스트로 띄워주시면 될 것 같고,
저장하지 않은 챌린지의 경우 **'저장하기'**를 디자인대로 띄워주시면 될 것 같습니다!
\n
postId 부분에는 저장할 포토챌린지 게시물의 Id를 전달해 주시면 됩니다.
\n
존재하지 않는 챌린지의 경우 메세지와 함께 404 에러가 반환됩니다.
\n
담당자 - 최지민
\n

포토챌린지에서 좋아요를 클릭했을 시에 사용되는 API입니다.
\n
postId 부분에는 포토챌린지 게시물의 Id값을 전달해 주시면 됩니다.
\n
좋아요를 눌렀을 때 좋아요를 이미 눌렀던 사용자면 좋아요 감소처럼 응답값이 반환되고,
좋아요를 누르지 않았던 사용자면 좋아요 증가처럼 응답값이 반환됩니다.
\n
포토챌린지가 존재하지 않을 경우에는 404 에러와 함께 메세지가 반환됩니다.
\n
담당자 - 최지민
\n

사용자가 작성한 포토챌린지가 너무 많을 것 같아 페이징으로 구현하였습니다.
\n
우선 디자인에서 한 화면에 15개씩 사진이 들어갈 수 있어 pageSize도 15로 맞추었습니다. 변경이 필요하다면 연락주세요!
\n
- 최신순으로 정렬된 값을 넘겨줍니다.
  \n
- page는 0부터 시작입니다.
  \n
\n
searchOne은 검색어를 utf-8로 인코딩해서 전달해주세요.
\n
searchOne은 공백일 경우 API 호출을 막아주세요!
\n
totalPages는 전체 페이지 수를 뜻합니다.
\n
담당자 -장다연
\n

페이징은 15개씩 인기순으로 정렬하도록 구현했습니다. page는 0번부터 시작입니다.
\n
profileId는 게시글 작성자 ID, postID는 게시글 ID, postImgName은 사진 URL, blockChk은 차단여부를 표신한 것입니다. totalPages는 페이징 전체 페이지 수를 뜻합니다.
\n
담당자 - 장다연
\n

포토챌린지 가능 여부 판단하는 코드는 우선 구현하지 않았습니다. 필요 시 말씀해주세요!
\n
요청값
\n
- postContent : 작성 내용
  \n
- challengeId : 챌린지 상세 조회 API를 통해 받은 challengeId를 입력해주세요.
  \n
- file : 포토챌린지한 이미지
  \n
\n
성공시 \"Post Add Successful\" 문자열이 201과 함께 리턴됩니다.
\n
담당자 - 장다연
\n

커뮤니티 부분에 포토챌린지 관련 API입니다.

포토챌린지 작성 같은 API는 포토챌린지 탭에 따로 구현될 것 같습니다.

\n","_postman_id":"44395dcd-2593-4c26-a0a2-f3af4bf9cfb5","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","name":"Tripture API Documentation","type":"collection"}}}],"id":"4f38e3a6-27a5-47fa-abd3-e55dae3aece1","description":"

커뮤니티 관련 API입니다.

\n","_postman_id":"4f38e3a6-27a5-47fa-abd3-e55dae3aece1","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","name":"Tripture API Documentation","type":"collection"}}},{"name":"홈","item":[{"name":"관광지 북마크 저장 여부","id":"5dfa56fa-5a06-46a4-a764-e6bf6f5f07c7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8080/bookmark/check/content/2757454","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","name":"Tripture API Documentation","type":"collection"}},"urlObject":{"protocol":"http","port":"8080","path":["bookmark","check","content","2757454"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"7462ac0c-6930-4fc2-8f7d-26d9ec32760b","name":"저장 X","originalRequest":{"method":"GET","header":[],"url":"http://localhost:8080/bookmark/check/content/125658"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 19 Sep 2024 13:41:55 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"false"},{"id":"84da06b6-3f7b-4321-9e12-947d5237e410","name":"저장 O","originalRequest":{"method":"GET","header":[],"url":"http://localhost:8080/bookmark/check/content/2757454"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 19 Sep 2024 13:42:16 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"true"}],"_postman_id":"5dfa56fa-5a06-46a4-a764-e6bf6f5f07c7"},{"name":"관광지 북마크 저장 or 삭제","id":"bd2b7073-8cf6-40b8-8172-b73475e31514","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"http://localhost:8080/bookmark/save/content/{{contentId}}","description":"

홈 부분에서 관광지를 북마크 저장할 때 사용되는 API 입니다.
\n
북마크를 등록, 삭제할 경우 같은 API를 사용하시면 됩니다.
\n
- 사용자가 이미 북마크로 등록한 관광지일 경우
  -> Bookmark deletion successful
  \n
- 사용자가 북마크로 등록한 관광지가 아닐 경우
  -> Bookmark Save Successful
  \n
\n
contentId 부분에는 오픈 API에서 사용되는 contentId(관광지 식별 가능한 Id)를 넣어주시면 됩니다.
\n
담당자 - 최지민
\n

홈 관련 API 입니다.

\n","_postman_id":"b0ce1e89-1159-483d-94f6-2ee2feca6a64","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","name":"Tripture API Documentation","type":"collection"}}},{"name":"포토챌린지","item":[{"name":"포토챌린지 상세 정보 조회 (challengeId 조회)","id":"dd35cd82-c8d3-4ce7-a057-dcbcf8bfd2b1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8080/challenge/challengeId/1","description":"

포토챌린지에서 챌린지가 열리는 장소의 상세 정보를 조회하는 API 입니다.
\n
조회 시에는 challengeId로 검색해 주시면 됩니다!
\n
응답 값
\n
- challengeId : 챌린지 장소의 저희 고유 Id로, 챌린지 작성 시에 보내야 할 값이라 응답 값에 포함했습니다.
  \n
- challengeImgUrl : 챌린지 장소에 관한 사진 정보입니다. 해당 사진은 기획팀에서 넘겨주시지 않아 일단 임의로 넣어놨는데, 사진이 여러 장일 경우 리스트로 전송될 예정입니다.
  \n
- challengeName : 챌린지 장소 이름입니다.
  \n
- challengeContent : 챌린지 장소에 관한 설명입니다.
  \n
- challengePoint : 챌린지를 참여했을 때 받는 포인트입니다.
  \n
- challengeParticipate : 사용자가 해당 포토 챌린지에 참여했는지를 나타내는 응답 값입니다. 이미 참여한 챌린지의 경우 버튼에 \"이미 참여한 챌린지입니다\"를 띄워주시면 될 것 같습니다.
  이미 참여한 챌린지입니다. -> true
  챌린지 참여하기 -> false
  \n
\n
해당 챌린지가 존재하지 않을 경우 400 에러와 함께 메시지가 반환됩니다.
\n
담당자 - 최지민
\n

포토챌린지에서 챌린지가 열리는 장소의 상세 정보를 조회하는 API 입니다.
\n
조회 시에는 오픈 API에서 사용되는 contentId (장소의 고유 Id)를 path에 같이 보내주시면 됩니다.
\n
응답 값
\n
- challengeId : 챌린지 장소의 저희 고유 Id로, 챌린지 작성 시에 보내야 할 값이라 응답 값에 포함했습니다.
  \n
- challengeImgUrl : 챌린지 장소에 관한 사진 정보입니다. 해당 사진은 기획팀에서 넘겨주시지 않아 일단 임의로 넣어놨는데, 사진이 여러 장일 경우 리스트로 전송될 예정입니다.
  \n
- challengeName : 챌린지 장소 이름입니다.
  \n
- challengeContent : 챌린지 장소에 관한 설명입니다.
  \n
- challengePoint : 챌린지를 참여했을 때 받는 포인트입니다.
  \n
- challengeParticipate : 사용자가 해당 포토 챌린지에 참여했는지를 나타내는 응답 값입니다. 이미 참여한 챌린지의 경우 버튼에 \"이미 참여한 챌린지입니다\"를 띄워주시면 될 것 같습니다.
  이미 참여한 챌린지입니다. -> true
  챌린지 참여하기 -> false
  \n
\n
해당 챌린지가 존재하지 않을 경우 400 에러와 함께 메시지가 반환됩니다.
\n
담당자 - 최지민
\n

2km 반경 안에 있는 포토챌린지를 조회하는 API 입니다.
\n
현재 위치의 위도 경도는 body에, 정렬 기준은 params에 주시면 됩니다.
\n
- params
  \n
  - 기본 : postViewCount
    \n
  - 조회순 : postViewCount
    \n
  - 좋아요순 : postLikeCount
    \n
  \n
\n
응답값
\n
- challengeId : 포토챌린지 ID
  \n
- challengeImgName : 포토챌린지 장소의 이미지 url
  \n
- challengePoint : 포토챌린지 장소명
  \n
- challengeRegion : 포토챌린지 지역명
  \n
- distance_meter : 미터 단위 포토챌린지로부터 거리
  \n
- participants : 해당 포토챌린지 참가자 수
  \n
- isChallengeParticipate : 해당 포토챌린지 참가했는지 여부
  \n
  - 주의! true일 경우에는 회원이 작성한 게시물로 이동, false일 경우 포토챌린지 참여 페이지로 이동해야합니다.
  \n
\n
담당자 - 장다연
\n

포토챌린지에서 인기 포토챌린지 10개를 보여주는 API입니다.
\n
params
\n
- 기본 : postViewCount
  \n
- 조회순 : postViewCount
  \n
- 좋아요순 : postLikeCount
  \n
\n
응답값
\n
- profileId : 사용자ID
  \n
- postId : 게시물ID
  \n
- postImgName : 사용자가 올린 게시물 이미지 url
  \n
- challengePoint : 챌린지명
  \n
- blockChk : 사용자가 차단한 게시물인지
  \n
\n
담당자 - 장다연
\n

포토챌린지 관련 API 입니다.

\n","_postman_id":"332a6d12-1fc6-4584-9f85-c3c7a41e6223","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","id":"0c1bae46-b123-49c5-a782-f5535d2a7daa","name":"Tripture API Documentation","type":"collection"}}},{"name":"신고","item":[{"name":"신고 등록","id":"48ae0530-05bd-47fe-90dc-5e88df4745d3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reportType\": \"comment\",\r\n \"postOrCommentId\": 2,\r\n \"reportContent\": \"광고성 댓글입니다.\",\r\n \"reportCategory\": \"스팸 또는 광고\",\r\n \"reportBlockChk\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/report/save","description":"

신고 등록 시에 사용되는 API 입니다.
\n
요청값
\n
- reportType : 사용자가 어떤 것을 신고하는지 표시하는 필드입니다.
  post -> 포토챌린지 신고
  comment -> 댓글 신고
  \n
- postOrCommentId : 사용자가 신고하는 포토챌린지 게시물의 Id나 댓글의 Id
  \n
- reportContent : 신고 내용
  \n
- reportCategory : 라디오 버튼 선택 내용
  \n
- reportBlockChk : 사용자의 차단 여부
  \n
\n
응답값
\n
- 포토챌린지 : Saved post Report Successfully
  \n
- 댓글 : Saved comment Report Successfully
  \n
\n
담당자 - 최지민
\n

지도에서 2km 반경 안에 있는 포토챌린지를 조회하는 API 입니다.
\n
현재 위치의 위도 경도만 보내주시면 됩니다.
\n
응답값
\n
- contentId : 오픈 API에서 사용되는 관광지 고유 contentId값
  \n
- challengeName : 포토챌린지 이름 ( 테스트 값에는 이렇게 되어있지만, 추후 저장 시에는 \"지역명 + 장소\" 이런 식으로 저장될 것 같습니다!
  \n
- challengeImgUrl : 포토챌린지 장소의 이미지 url
  \n
- challengeContent : 포토챌린지 장소 설명
  \n
- challengePoint : 포토챌린지 참여 시 포인트
  \n
- challengeRegion : 어떤 지역에서 실행되는 포토 챌린지인지 ( 홈을 기준으로 나눈 지역 정보입니다! challengeName에 포함되는 지역과 다를 수 있습니다! )
  \n
- challengeLat : 챌린지가 열리는 위도
  \n
- challengeLon : 챌린지가 열리는 경도
  \n
\n
담당자 - 최지민
\n

홈에서 관광지 상세 정보 확인 시에 해당 관광지에서 포토챌린지가 진행 중인지 확인하는 API 입니다.
\n
contentId 부분에 오픈 API 조회 시에 사용되는 contentId를 넣어주시면 됩니다.
\n
현재 포토챌린지가 진행 중일 경우에는 true
포토챌린지가 진행 중이지 않을 경우에는 false
가 반환됩니다.
\n
포토챌린지가 진행 중일 경우에는 버튼에 '챌린지 참여'를 띄워주시면 될 것 같고,
진행 중이지 않을 경우에는 버튼을 회색 처리하거나 누를 수 없도록 처리해 주시면 될 것 같습니다!
\n
담당자 - 최지민
\n