> For the complete documentation index, see [llms.txt](https://documenttesting.gitbook.io/ecolog-api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documenttesting.gitbook.io/ecolog-api-reference/ecolog-api.md).

# EcoLog API 개요

## EcoLog 서비스 소개

<figure><img src="/files/sg6A7EyuSCcQX2WNKQ4d" alt=""><figcaption></figcaption></figure>

Eco Log는 하루동안 환경을 위해 실천한 사항을 기록하는 웹앱 서비스입니다. 제로웨이스트를 위해 가벼운 실천을 시도해보고자하는 사용자의 꾸준함을 응원하고 지원하기 위해 기획 및 개발하였습니다.

서비스의 주요 기능은 다음과 같습니다.

* 로그인: 카카오, 네이버, 구글 소셜 로그인
* 프로필: 사용자의 실천 현황을 요약해 제공
* 게시물: 실천 카테고리 또는 직접 입력 실천과 하루 소감을 담은 게시물을 발행하고 수정
* 팔로우: 팔로잉, 팔로워를 조회하고 관리
* 게시물 하트: 팔로우 중인 사용자의 실천 게시물에 좋아요 표시
* 뱃지: 특정 행동을 수행할 때마다 제공되는 뱃지를 조회

## API 퀵 레퍼런스 테이블

<table><thead><tr><th width="124">구분</th><th width="123">메서드</th><th width="223">엔드포인트</th><th>설명</th></tr></thead><tbody><tr><td>로그인</td><td><mark style="background-color:blue;">GET</mark></td><td><a href="/pages/xy8jEoDsMLdVeCaKooqD#kakao">/api/oauth/kakaotoken</a></td><td>카카오 소셜 로그인</td></tr><tr><td></td><td><mark style="background-color:blue;">GET</mark></td><td><a href="/pages/xy8jEoDsMLdVeCaKooqD#naver">/api/oauth/navertoken</a></td><td>네이버 소셜 로그인</td></tr><tr><td></td><td><mark style="background-color:blue;">GET</mark></td><td><a href="/pages/xy8jEoDsMLdVeCaKooqD#google">/api/oauth/googletoken</a></td><td>구글 소셜 로그인</td></tr><tr><td></td><td><mark style="background-color:blue;">GET</mark></td><td><a href="/pages/xy8jEoDsMLdVeCaKooqD#loginuser">/api/me</a></td><td>현재 로그인 중인 유저 조회</td></tr><tr><td></td><td><mark style="background-color:red;">DELETE</mark></td><td><a href="/pages/xy8jEoDsMLdVeCaKooqD#withdraw">/api/user</a></td><td>유저 탈퇴</td></tr><tr><td>프로필</td><td><mark style="background-color:blue;">GET</mark></td><td><a href="/pages/XDbKsDBTKhho9OLGk32u#view">/api/user/profile</a></td><td>프로필(실천 현황) 조회</td></tr><tr><td></td><td><mark style="background-color:green;">POST</mark></td><td><a href="/pages/XDbKsDBTKhho9OLGk32u#edit">/api/user/profile</a></td><td>프로필 수정</td></tr><tr><td></td><td><mark style="background-color:blue;">GET</mark></td><td><a href="/pages/XDbKsDBTKhho9OLGk32u#summary">/api/user/summary</a></td><td>유저 실천 정보 요약 조회</td></tr><tr><td></td><td><mark style="background-color:blue;">GET</mark></td><td><a href="/pages/XDbKsDBTKhho9OLGk32u#search">/api/user/search</a></td><td>유저 검색</td></tr><tr><td>게시물</td><td><mark style="background-color:green;">POST</mark></td><td><a href="/pages/n795vg4yZM0zV8pSMh0Z#save">/api/post</a></td><td>게시물 저장</td></tr><tr><td></td><td><mark style="background-color:orange;">PUT</mark></td><td><a href="/pages/n795vg4yZM0zV8pSMh0Z#edit">/api/post/change</a></td><td>게시물 수정</td></tr><tr><td></td><td><mark style="background-color:red;">DELETE</mark></td><td><a href="/pages/n795vg4yZM0zV8pSMh0Z#delete">/api/post</a></td><td>게시물 삭제</td></tr><tr><td></td><td><mark style="background-color:blue;">GET</mark></td><td><a href="/pages/n795vg4yZM0zV8pSMh0Z#feed">/api/post/daily</a></td><td>피드 조회</td></tr><tr><td></td><td><mark style="background-color:blue;">GET</mark></td><td><a href="/pages/n795vg4yZM0zV8pSMh0Z#monthly">/api/post/Monthly</a></td><td>게시물 월 단위 조회</td></tr><tr><td>실천</td><td><mark style="background-color:blue;">GET</mark></td><td><a href="/pages/MvzNPGKG8l97l75lbvOH#view">/api/behavior</a></td><td>전체 실천 ID 및 이름 조회</td></tr><tr><td>팔로우</td><td><mark style="background-color:green;">POST</mark></td><td><a href="/pages/Hne5u6hjE1VjWMYS41FC#add">/api/user/follow</a></td><td>유저 팔로우</td></tr><tr><td></td><td><mark style="background-color:red;">DELETE</mark></td><td><a href="/pages/Hne5u6hjE1VjWMYS41FC#unfollow">/api/user/follow</a></td><td>유저 팔로우 취소</td></tr><tr><td></td><td><mark style="background-color:blue;">GET</mark></td><td><a href="/pages/Hne5u6hjE1VjWMYS41FC#follower">/api/user/follower</a></td><td>팔로워 조회</td></tr><tr><td></td><td><mark style="background-color:blue;">GET</mark></td><td><a href="/pages/Hne5u6hjE1VjWMYS41FC#following">/api/user/following</a></td><td>팔로잉 조회</td></tr><tr><td></td><td><mark style="background-color:red;">DELETE</mark></td><td><a href="/pages/Hne5u6hjE1VjWMYS41FC#view">/api/user/follower</a></td><td>팔로워 삭제</td></tr><tr><td>게시물 하트</td><td><mark style="background-color:green;">POST</mark></td><td><a href="/pages/7cqyZyOswbne9U3GA77y#active">/api/post/heart</a></td><td>하트 활성화</td></tr><tr><td></td><td><mark style="background-color:red;">DELETE</mark></td><td><a href="/pages/7cqyZyOswbne9U3GA77y#unactive">/api/post/heart</a></td><td>하트 활성화 취소</td></tr><tr><td>뱃지</td><td><mark style="background-color:blue;">GET</mark></td><td><a href="/pages/58YMTzO8WVq9EpoV4JKt#view">/api/user/badge</a></td><td>유저 뱃지 획득 정보 조회</td></tr></tbody></table>

## Base URL

API 호출 시 base URL은 다음과 같습니다.

<table><thead><tr><th width="200">항목</th><th>URL</th></tr></thead><tbody><tr><td>Base URL</td><td><code>https://www.eco-log-backend.kro.kr</code></td></tr></tbody></table>

## HTTP 상태 코드

<table><thead><tr><th width="200">HTTP 상태 코드</th><th>설명</th></tr></thead><tbody><tr><td>200</td><td>성공</td></tr><tr><td>400</td><td>잘못된 요청</td></tr><tr><td>401</td><td>유효하지 않은 토큰</td></tr><tr><td>444</td><td>만료된 토큰</td></tr></tbody></table>

## 문서 버전

* 2023.02.09. 문서 첫 생성