Manage your customer's projects and user data in your website with our Measure Map Online APIs integration.

REST API

Open Guest

How it works?

  1. Your potential customer (PC) visits your website to get an estimate for your service. Enters their name, email, contact information, materials picked... and presses a 'Request Quote' button.
  2. Using the API calls, you redirect the PC to Measure Map Online where an Open Guest Project gets created automatically in your repository and they can start measuring without having an account.
  3. You'll receive an email notification as soon as the PC is in the newly created project.
  4. The estimate/pricing will appear for the PC while they are measuring.
  5. Manually review the requested estimates from your PCs as they will appear in your projects repository.
  6. Generate a Guest Link for any Open Guest project so that your PCs can re-edit the same project.

How to integrate into your website?

01. Get API Key

Subscribe to the Open Guest plan to get access to the Developer section and Generate API Key.

02. Get Access Token

Create an Access Token using POST /auth/token/. (See Documentation)

03. Redirect to Guest Project

Create a link for a new Guest project for the 'Request Quote' button on your website to redirect your visitor.

                
                function startMeasuring(){
                    const clientName = 'John Doe';
                    const clientEmail = 'john@doe.com';
                    const projectName = 'Measurements from John Doe';
                    const projectDescription = 'Client Name: ' + clientName + ', Client Email: ' + clientEmail;

                    const folderId = '[FOLDER_ID] '; // Optional, remove if you want the project to be created in the root folder
                    const apiKey = '[API_KEY]';
                    const token = getAccessToken(); // Using the Custom Token API POST https://api.measuremaponline.com/api/v1/auth/token (https://apidoc.measuremaponline.com/#681cc8ef-edfb-48e9-ac30-5e6055c3d3e0)
                    const url = 'https://app.measuremaponline.com/app/projects/guest/new?'
                    + 'name=' + projectName
                    + '&description=' + projectDescription // Project description can include any information you like to store for this project. (you can search by description in your repository)
                    + '&folder_id=' + folderId // Optional, remove if you want the project to be created in the root folder
                    + '&guest_name=' + clientName // Optional, you'll receive this information in the email notification
                    + '&guest_email=' + clientName // Optional, you'll receive this information in the email notification
                    + '&token=' + token;

                    window.open(url, '_blank');
                    }
                
            
03. Done.

Your potential customer can now measure and get estimates based on your preferences. You can check out the project live in your repository and manage the projects using REST API.

Enterprise
01. Get API Key

Subscribe to the Enterprise plan to get access to the Developer section and Generate API Key.

02. Create Users

Create users from your Dashboard or using the REST API.

POST /users/new

03. Link users to your DB

Link the Enterprise UID (User ID) you just created to a customer in your database. You can use the REST API to get the User info.

GET /users/:uid

04. Create Projects

Create a project and link it to your customer's content in your database.

POST /users/:uid/projects/new

05. Create Sign-in Token

Generate a Sign-in Token using the API to redirect your user to Measure Map Online with auto-signin, this way you don't have to share the credentials you created for each user in your Enterprise subscription. and link it to your customer's content in your database.

https://app.measuremaponline.com/?sit=TOKEN

iFrame API

In Your Website, your customer can view a project that you created for their content, and when they click on it to edit it, it will redirect log them in automatically to Measure Map Online using your API Key and their UID provided in the iFrame url.

Estimating Software

Proposal 1

...