Vai al contenuto

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 piani

Crea 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 API

Inviala 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 cartelleElencali, leggili, creali, aggiornali ed eliminali; leggi le misure, i commenti e il file .mmp di un progettoOpen Guest e Enterprise
ProdottiLeggi, crea, aggiorna e archivia i prodotti con cui calcoli il prezzo del tuo lavoroOpen Guest e Enterprise
Progetti ospiteAvvia un progetto ospite per un visitatore, con i suoi dati già compilatiOpen Guest
MembriCrea, leggi, aggiorna e rimuovi i membri della tua organizzazione e fai accedere i loro accountEnterprise
EmbedMostra un progetto come mappa dal vivo sul tuo sito webEnterprise
WebhookRicevi sul tuo server un messaggio firmato quando succede qualcosaOpen 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

  1. Inserisci il tuo link ospite nel sito web, come pulsante o come mappa dentro una pagina.
  2. 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.
  3. Disegna il suo prato, il tetto o il vialetto e vede i tuoi prezzi mentre procede.
  4. Preme Richiedi un preventivo e lascia nome, email e telefono.
  5. 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 Guest

Dal 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/new

Collegali 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/new

Falli 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=TOKEN

iFrame 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

Esempio: un progetto dentro la tua pagina

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.createdViene creato un progetto, nell'app, tramite l'API o da un embed
project.deletedUn progetto viene eliminato definitivamente (spostarlo nel Cestino non conta)
project.comment.addedQualcuno commenta un progetto
guest.project.createdUn visitatore avvia un progetto ospite e il suo indirizzo email è noto, ad esempio dal tuo modulo di preventivo (Open Guest)
guest.measurement.completedUn 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.createdViene aggiunto un posto alla tua organizzazione, anche tramite single sign-on (Enterprise)