GrowSpace
Manual

API Common Guide

2026년 09월 25일

📢 API Common Guide Overview

This API allows external systems to create, retrieve, update, and delete map and place information. Using the API requires a separate authentication key (API Key), and communication is based on the JSON format.

This API is continuously updated to improve quality and features, and some functionality may change or be discontinued during this process.


📃 API Common Guide Contents

The API Common Guide covers the following:

  • Place
    • Retrieve Place UID List
    • Retrieve Details by Place UID
    • Update Details by Place UID
  • Map
    • Retrieve Project GeoJSON
    • Retrieve Floor GeoJSON
    • Update Map Color by Place

🔗 Base URL

The URL for the Growspace API follows this format.

https://space.api-freegrow.com

🔐 API Authentication

To use the API, the issued API Key must be included in the request header.
You can issue an API Key by following the steps below.

✅ API Key Issuance Steps
  1. Log in to the service, or sign up if you don’t have an account.
  2. If you don’t have an account, please sign up first.
  3. After logging in, you’ll be taken to the home screen.
  4. Select a project
  5. Click the profile menu in the top right
  6. Click the profile icon in the top right of the project detail page.
  7. Click [API Key Generate] from the menu that appears to automatically issue an API Key.
  8. The issued key is displayed on screen and can be copied for use.
  9. Note that reissuing the authentication key invalidates the previous key.
🔑 API Authentication Method

When making an API request, include the API Key in the api-key header as shown below.

api-key : {YOUR_API_KEY}

Example:

curl -X GET https://space.api-freegrow-test.com
  -H "{YOUR_API_KEY}"
PDF로 내려받아 현장에서 보세요

Table of Contents