api_spec

• 개요
• 회원 API
  • 회원가입
  • 로그인
  • 로그아웃
• 카테고리 API
  • 카테고리 조회
  • 카테고리 생성
  • 카테고리 수정
  • 카테고리 삭제
• 커뮤니티 피드 게시판 API
  • 커뮤니티 게시판 조회
  • 커뮤니티 회원별 게시판 조회
  • 커뮤니티 특정 게시물 조회
  • 커뮤니티 게시물 작성
  • 커뮤니티 게시물 수정
  • 커뮤니티 게시물 삭제
• 농사로 실내정원용 식물 API
  • 실내정원용 식물 목록
  • 실내정원용 식물 상세

개요

• api 스펙

회원 API

회원가입

• api: /api/v1/user/signup
• http method: POST
• 요청 헤더

Content-Type: application/json;charset=UTF-8

• request_body

{
    "email": "hello@world.com",
    "password": "password",
    "nickname": "testuser"
}

• 성공 응답

201 CREATED
{
  "id": "1" ; 생성 id
}

로그인

• api: /api/v1/user/signin
• http method: POST
• request_body: json

{
  "email": "",
  "password": ""
}

• 성공 응답
  • status_code: 200 OK
  • header: Authorization bearer return
• 실패 응답
  • status_code: 401 Unauthorized

로그아웃 (to do)

• api: /api/v1/user/logout

• http method: POST

• 성공 응답

200 OK

카테고리 API

카테고리 조회

• api: /category
• http method: GET
• 요청 헤더

Content-Type: application/json;charset=UTF-8

카테고리 생성

• api: /category
• http method: POST
• 요청 헤더

Content-Type: application/json;charset=UTF-8
cookie: "JESSIONID: <id>"

• request_body

{
    "name": "",
    "parentId": 0L
}

카테고리 수정

• api: /category/{category_id}
• http method: PUT
• 요청 헤더

Content-Type: application/json;charset=UTF-8
cookie: "JESSIONID: <id>"

• request_body

{
    "name": "",
    "parentId": ""
}

카테고리 삭제

• api: /category/{category_id}
• http method: DELETE
• 요청 헤더

Content-Type: application/json;charset=UTF-8
cookie: "JESSIONID: <id>"

커뮤니티 피드 게시판 API

커뮤니티 게시판 조회

• api: /board
• http method: GET
• 요청 헤더

Content-Type: application/json;charset=UTF-8

커뮤니티 회원별 게시판 조회

• api: /board/{account_id}
• http method: GET
• 요청 헤더

Content-Type: application/json;charset=UTF-8

커뮤니티 특정 게시물 조회

• api: /board/{board_id}
• http method: GET
• 요청 헤더

Content-Type: application/json;charset=UTF-8

커뮤니티 게시물 작성

• api: /board
• http method: POST
• 요청 헤더

Content-Type: application/json;charset=UTF-8
cookie: "JESSIONID: <id>"

• request_body

{
    "content": "",
    "account": {}
}

커뮤니티 게시물 수정

• api: /board/{board_id}
• http method: PUT
• 요청 헤더

Content-Type: application/json;charset=UTF-8
cookie: "JESSIONID: <id>"

• request_body

{
    "content": "",
}

커뮤니티 게시물 삭제

• api: /board/{board_id}
• http method: DELETE
• 요청 헤더

Content-Type: application/json;charset=UTF-8
cookie: "JESSIONID: <id>"

[실내정원용 식물 API]

실내정원용 식물 목록

• api: /gardenList
• request_body

{
  "sType" : (한명 : sPlntbneNm, 식물명 : sCntntsSj, 영명 : sPlntzrNm)
  "sText" : (검색어)
  "word" : (ㄱ & ㄴ & A & B)
}

실내정원용 식물 상세

• api: /gardenDtl/{cntntsNo}
• request_heder 컨텐츠번호

• 샘플화면 http://api.nongsaro.go.kr/sample/rest/garden/gardenList.jsp
• 매뉴얼 다운로드 https://www.nongsaro.go.kr/portal/ps/psn/psnj/openApiLst.ps?menuId=PS65428&pageIndex=1&pageSize=&sLclasCode=691005&sText=실내