📢 API 공통 가이드 개요

이 API는 외부 시스템에서 지도 및 플레이스 정보를 등록, 조회, 수정, 삭제할 수 있도록 제공하는 API입니다. API 사용을 위해서는 별도 인증키(API Key)가 필요하며, JSON 포맷 기반으로 통신합니다.

본 API는 품질 향상과 기능 개선을 위해 지속적으로 업데이트되며, 이 과정에서 일부 기능이 변경되거나 제공이 종료될 수 있습니다.

📃 API 공통 가이드 구성

API 공통 가이드의 내용은 다음과 같습니다.

• Place
  • Place UID List 호출
  • Place UID별 Details 호출
  • Place UID별 Details 수정
• Map
  • Project geojson 호출
  • 층 별 geojson 호출
  • Place별 map color 수정

🔗 Base URL

Growspace API의 URL은 다음과 같은 형식을 따릅니다.

https://space.api-freegrow.com

🔐 API 인증

API 사용을 위해서는 발급받은 API Key를 요청 헤더에 포함해야 합니다.
API Key는 아래 절차에 따라 발급할 수 있습니다.

✅ API KEY 발급 절차

1. 서비스 로그인 또는 회원가입
2. 계정이 없는 경우 먼저 회원가입을 진행해 주세요.
3. 로그인 후, 홈 화면 페이지로 이동됩니다.
4. 프로젝트 선택
5. 우측 상단의 프로필 메뉴 클릭
6. 프로젝트 상세 페이지 우측 상단에 있는 프로필 아이콘을 클릭합니다.
7. 나타나는 메뉴에서 [API Key Generate] 메뉴를 클릭하면 API Key가 자동 발급됩니다.
8. 발급된 키는 화면에 표시되며, 복사하여 사용할 수 있습니다.
9. 단, 인증키 재 발급시, 기존 인증키는 사용할 수 없습니다.

api-key : {YOUR_API_KEY}

curl -X GET https://space.api-freegrow-test.com
  -H "{YOUR_API_KEY}"