📢 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

- Log in to the service, or sign up if you don’t have an account.
- If you don’t have an account, please sign up first.
- After logging in, you’ll be taken to the home screen.
- Select a project
- Click the profile menu in the top right
- Click the profile icon in the top right of the project detail page.
- Click [API Key Generate] from the menu that appears to automatically issue an API Key.
- The issued key is displayed on screen and can be copied for use.
- 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}"
