Measure Map Online per sviluppatori
Permetti ai visitatori di misurare sul tuo sito web, crea progetti per i tuoi clienti, leggi le loro misure e vieni a sapere dei cambiamenti nel momento in cui accadono. La REST API fa parte dei piani Open Guest ed Enterprise.
REST API
Scegli il tuo piano
La pagina Sviluppatore si apre con i piani Open Guest ed Enterprise. Open Guest serve a ricevere richieste di preventivo dal tuo sito web; Enterprise serve a gestire un team, con membri che gestisci tramite l'API.
Confronta i pianiCrea una chiave API
Nella pagina Sviluppatore crea una chiave Live per i tuoi progetti reali e una chiave Sandbox per sviluppare e testare: i progetti sandbox restano separati e i progetti ospite sandbox non vengono mai fatturati. Dai a ogni chiave solo l'accesso che le serve e limitala ai tuoi siti web.
Informazioni sulle chiavi APIInviala con ogni richiesta
Ogni richiesta va a https://api.measuremaponline.com/api/v2, con la tua chiave nell'intestazione Authorization. Conserva sul tuo server le chiavi che possono modificare i dati.
curl https://api.measuremaponline.com/api/v2/projects/PROJECT_ID \
-H "Authorization: YOUR_API_KEY"
Cosa puoi fare
| Area | Cosa può fare il tuo software | Piani |
|---|---|---|
| Progetti e cartelle | Elencali, leggili, creali, aggiornali ed eliminali; leggi le misure, i commenti e il file .mmp di un progetto | Open Guest e Enterprise |
| Prodotti | Leggi, crea, aggiorna e archivia i prodotti con cui calcoli il prezzo del tuo lavoro | Open Guest e Enterprise |
| Progetti ospite | Avvia un progetto ospite per un visitatore, con i suoi dati già compilati | Open Guest |
| Membri | Crea, leggi, aggiorna e rimuovi i membri della tua organizzazione e fai accedere i loro account | Enterprise |
| Embed | Mostra un progetto come mappa dal vivo sul tuo sito web | Enterprise |
| Webhook | Ricevi sul tuo server un messaggio firmato quando succede qualcosa | Open Guest e Enterprise |
Open Guest: i visitatori del tuo sito web misurano da soli il loro lavoro
I visitatori del tuo sito web misurano il loro lavoro senza un account, vedono il prezzo mentre disegnano e ti inviano una richiesta di preventivo.
Come funziona
- Inserisci il tuo link ospite nel sito web, come pulsante o come mappa dentro una pagina.
- Un visitatore lo apre, o trova il suo indirizzo sulla mappa nella tua pagina, e ottiene un progetto tutto suo in una nuova scheda, senza doversi iscrivere a nulla.
- Disegna il suo prato, il tetto o il vialetto e vede i tuoi prezzi mentre procede.
- Preme Richiedi un preventivo e lascia nome, email e telefono.
- Ricevi un'email e una notifica, e il suo progetto è nel tuo account.
Nessun codice necessario: copia il tuo link ospite, o il codice del pulsante o della mappa, da Sviluppatore > Link ospite.
Come funziona Open GuestDal tuo modulo di preventivo
Per compilare al posto del visitatore i suoi dati, il tuo server richiede un token con la tua chiave live e invia il visitatore a un nuovo progetto ospite. La chiave non raggiunge mai il browser.
// Node.js 18+ with Express. Your API key stays on this server.
const express = require('express');
const app = express();
app.get('/start-measuring', async (req, res) => {
// A token lets one visitor start one project in your account.
const reply = await fetch('https://api.measuremaponline.com/api/v2/auth/token', {
method: 'POST',
headers: {'Authorization': process.env.MMO_API_KEY, 'Content-Type': 'application/json'},
body: '{}',
});
if (!reply.ok) {
return res.sendStatus(502);
}
const {token} = await reply.json();
const name = String(req.query.name || '');
const email = String(req.query.email || '');
// URLSearchParams encodes every value: "Smith & Sons" arrives whole.
const params = new URLSearchParams({
token,
name, // the project's name in your account
description: email, // any text you want to search by later
guest_name: name, // shown in the email you receive
guest_email: email,
// folder_id: 'FOLDER_ID', // optional: the folder new projects go into
});
res.redirect('https://app.measuremaponline.com/app/projects/guest/new?' + params.toString());
});
app.listen(3000);
// On your page: call this from the button on your quote form.
function startMeasuring(name, email) {
const params = new URLSearchParams({name, email});
window.open('/start-measuring?' + params.toString(), '_blank', 'noopener');
}
La pagina Sviluppatore ha questo codice pronto per il tuo account, in Link ospite > Open Guest API. Ogni progetto ospite viene conteggiato nel tuo utilizzo di Open Guest.
Enterprise: i tuoi membri, dal tuo software
Crea le persone della tua organizzazione dal tuo sistema, assegna loro dei progetti e mandale in Measure Map Online già autenticate.
Crea i membri
Invita le persone dalla dashboard oppure creale con l'API. Ogni membro occupa un posto e riceve il ruolo predefinito della tua organizzazione.
POST /users/newCollegali ai tuoi dati
Salva l'ID utente di ogni membro (uid) insieme al cliente o al dipendente nel tuo database e leggi i suoi dati quando ti servono.
GET /users/{uid}Crea i loro progetti
Crea un progetto nell'account di un membro e conserva il suo ID insieme al lavoro nel tuo sistema.
POST /users/{uid}/projects/newFalli accedere
Richiedi un token di accesso e manda il membro nell'app con quello, così non devi mai distribuire password. Non disponibile per Admin e Manager, né con una chiave sandbox.
POST /auth/{uid}/login
https://app.measuremaponline.com/dashboard?sit=TOKENiFrame API: una mappa dal vivo sul tuo sito web
Mostra la mappa di un progetto, con le tue misure, dentro la tua pagina web o il tuo CRM. I visitatori possono muoversi al suo interno senza un account. Scegli le unità, il tipo di mappa e un aspetto chiaro o scuro.
La pagina Sviluppatore crea il codice per te: scegli un progetto, controlla l'anteprima dal vivo e copialo. Gli embed fanno parte del piano Enterprise; con Open Guest, incorpora invece il tuo link ospite.
Guida alla iFrame API<iframe
src="https://app.measuremaponline.com/iframe_api?pid=PROJECT_ID&key=YOUR_API_KEY&ms=metric&maptype=satellite&theme=auto"
width="100%" height="500" style="border: 0"
title="Misure del lavoro">
</iframe>
ms: metric o imperial
· maptype: satellite, map, hybrid o terrain
· theme: auto, light o dark
Webhook: scopri i cambiamenti
Aggiungi l'indirizzo del tuo server nella pagina Sviluppatore e scegli gli eventi che ti interessano. Ogni evento arriva come POST con un corpo JSON, firmato nell'intestazione X-MMO-Signature così puoi verificare che provenga da noi.
I webhook fanno parte dei piani Open Guest ed Enterprise.
Guida ai webhook| Evento | Inviato quando |
|---|---|
project.created | Viene creato un progetto, nell'app, tramite l'API o da un embed |
project.deleted | Un progetto viene eliminato definitivamente (spostarlo nel Cestino non conta) |
project.comment.added | Qualcuno commenta un progetto |
guest.project.created | Un visitatore avvia un progetto ospite e il suo indirizzo email è noto, ad esempio dal tuo modulo di preventivo (Open Guest) |
guest.measurement.completed | Un visitatore finisce di misurare e lascia i suoi recapiti (Open Guest) |
budget.warning_reached,budget.limit_reached | La tua spesa Open Guest raggiunge la soglia di avviso o il limite |
enterprise.user.created | Viene aggiunto un posto alla tua organizzazione, anche tramite single sign-on (Enterprise) |