Measure Map Online pentru dezvoltatori
Lasă vizitatorii să măsoare pe site-ul tău, creează proiecte pentru clienții tăi, citește măsurătorile lor și află de modificări în clipa în care apar. REST API face parte din planurile Open Guest și Enterprise.
REST API
Alege-ți planul
Pagina Dezvoltator se deschide în planurile Open Guest și Enterprise. Open Guest este pentru a primi cereri de ofertă de pe site-ul tău; Enterprise este pentru conducerea unei echipe, cu membri pe care îi gestionezi prin API.
Compară planurileCreează o cheie API
Pe pagina Dezvoltator, creează o cheie Live pentru proiectele tale reale și o cheie Sandbox pentru dezvoltare și testare: proiectele din sandbox rămân separate, iar proiectele de oaspete din sandbox nu sunt niciodată facturate. Dă fiecărei chei doar accesul de care are nevoie și limitează-o la site-urile tale.
Despre cheile APITrimite-o cu fiecare cerere
Fiecare cerere merge la https://api.measuremaponline.com/api/v2, cu cheia ta în antetul Authorization. Păstrează pe serverul tău cheile care pot modifica date.
curl https://api.measuremaponline.com/api/v2/projects/PROJECT_ID \
-H "Authorization: YOUR_API_KEY"
Ce poți face
| Domeniu | Ce poate face software-ul tău | Planuri |
|---|---|---|
| Proiecte și dosare | Listează, citește, creează, actualizează și șterge; citește măsurătorile unui proiect, comentariile și fișierul .mmp | Open Guest și Enterprise |
| Produse | Citește, creează, actualizează și arhivează produsele cu care îți calculezi lucrările | Open Guest și Enterprise |
| Proiecte de oaspete | Pornește un proiect de oaspete pentru un vizitator, cu datele lui deja completate | Open Guest |
| Membri | Creează, citește, actualizează și elimină membrii organizației tale și autentifică-i | Enterprise |
| Încorporări | Afișează un proiect ca hartă interactivă pe site-ul tău | Enterprise |
| Webhook-uri | Primește pe serverul tău un mesaj semnat când se întâmplă ceva | Open Guest și Enterprise |
Open Guest: vizitatorii site-ului tău își măsoară singuri lucrarea
Vizitatorii site-ului tău își măsoară singuri lucrarea, fără cont, văd prețul ei pe măsură ce desenează și îți trimit o cerere de ofertă.
Cum funcționează
- Pui linkul de oaspete pe site-ul tău, ca buton sau ca hartă într-o pagină.
- Un vizitator îl deschide sau își găsește adresa pe harta din pagina ta și primește un proiect propriu într-o filă nouă, fără nicio înregistrare.
- Își desenează gazonul, acoperișul sau aleea și vede prețurile tale pe măsură ce lucrează.
- Apasă Cere o ofertă și lasă numele, e-mailul și telefonul.
- Primești un e-mail și o notificare, iar proiectul lui apare în contul tău.
Fără cod: copiază linkul de oaspete, sau codul butonului ori al hărții, din Dezvoltator > Link de oaspete.
Cum funcționează Open GuestDin propriul formular de ofertă
Pentru a completa datele vizitatorului în locul lui, serverul tău cere un token cu cheia ta Live și trimite vizitatorul într-un proiect de oaspete nou. Cheia nu ajunge niciodată în 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');
}
Pagina Dezvoltator are acest cod pregătit pentru contul tău, la Link de oaspete > Open Guest API. Fiecare proiect de oaspete se numără în consumul tău Open Guest.
Enterprise: membrii tăi, din propriul software
Creează persoanele din organizația ta din propriul sistem, dă-le proiecte și trimite-le în Measure Map Online deja autentificate.
Creează membri
Invită oameni din tabloul de bord sau creează-i prin API. Fiecare membru ocupă un loc și primește rolul implicit al organizației tale.
POST /users/newLeagă-i de evidențele tale
Stochează ID-ul de utilizator (uid) al fiecărui membru lângă clientul sau angajatul din baza ta de date și citește-i datele când ai nevoie.
GET /users/{uid}Creează-le proiectele
Creează un proiect în contul unui membru și păstrează-i ID-ul alături de lucrare în propriul sistem.
POST /users/{uid}/projects/newAutentifică-i
Cere un token de autentificare și trimite membrul în aplicație cu el, ca să nu mai trebuiască să dai parole. Indisponibil pentru Admini și Manageri sau cu o cheie Sandbox.
POST /auth/{uid}/login
https://app.measuremaponline.com/dashboard?sit=TOKENiFrame API: o hartă interactivă pe site-ul tău
Afișează harta unui proiect, cu măsurătorile tale, în propria pagină web sau în CRM. Vizitatorii se pot mișca pe ea fără cont. Alege unitățile, tipul hărții și un aspect luminos sau întunecat.
Pagina Dezvoltator generează codul pentru tine: alege un proiect, verifică previzualizarea live și copiază-l. Încorporările fac parte din planul Enterprise; în Open Guest, încorporează în schimb linkul tău de oaspete.
Ghidul 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="Măsurătorile lucrării">
</iframe>
ms: metric sau imperial
· maptype: satellite, map, hybrid sau terrain
· theme: auto, light sau dark
Webhook-uri: află de modificări
Adaugă adresa serverului tău în pagina Dezvoltator și alege evenimentele dorite. Fiecare eveniment sosește ca un POST cu corp JSON, semnat în antetul X-MMO-Signature, ca să poți verifica că vine de la noi.
Webhook-urile fac parte din planurile Open Guest și Enterprise.
Ghidul webhook-urilor| Eveniment | Trimis când |
|---|---|
project.created | Se creează un proiect, în aplicație, prin API sau dintr-o încorporare |
project.deleted | Un proiect este șters definitiv (mutarea în Coșul de gunoi nu contează) |
project.comment.added | Cineva comentează un proiect |
guest.project.created | Un vizitator începe un proiect de oaspete și adresa lui de e-mail este cunoscută, de exemplu din formularul tău de ofertă (Open Guest) |
guest.measurement.completed | Un vizitator termină de măsurat și lasă datele de contact (Open Guest) |
budget.warning_reached,budget.limit_reached | Cheltuielile tale Open Guest ating pragul de avertizare sau limita |
enterprise.user.created | Se adaugă un loc în organizația ta, inclusiv prin autentificare unică (Enterprise) |