Measure Map Online για προγραμματιστές
Αφήστε τους επισκέπτες να μετρούν στον ιστότοπό σας, δημιουργήστε έργα για τους πελάτες σας, διαβάστε τις μετρήσεις τους και μάθετε για τις αλλαγές τη στιγμή που γίνονται. Το REST API περιλαμβάνεται στα πακέτα Open Guest και Enterprise.
REST API
Επιλέξτε το πακέτο σας
Η σελίδα Προγραμματιστής ανοίγει στα πακέτα Open Guest και Enterprise. Το Open Guest είναι για να λαμβάνετε αιτήματα προσφοράς από τον ιστότοπό σας· το Enterprise είναι για τη διαχείριση μιας ομάδας, με μέλη που διαχειρίζεστε μέσω του API.
Σύγκριση πακέτωνΔημιουργήστε ένα κλειδί API
Στη σελίδα Προγραμματιστής, δημιουργήστε ένα κλειδί Live για τα πραγματικά σας έργα και ένα κλειδί Sandbox για ανάπτυξη και δοκιμές: τα έργα του sandbox μένουν χωριστά και τα έργα επισκεπτών του sandbox δεν χρεώνονται ποτέ. Δώστε σε κάθε κλειδί μόνο την πρόσβαση που χρειάζεται και περιορίστε το στους ιστότοπούς σας.
Σχετικά με τα κλειδιά APIΣτείλτε το με κάθε αίτημα
Κάθε αίτημα πηγαίνει στο https://api.measuremaponline.com/api/v2, με το κλειδί σας στην κεφαλίδα Authorization. Κρατήστε στον διακομιστή σας τα κλειδιά που μπορούν να αλλάξουν δεδομένα.
curl https://api.measuremaponline.com/api/v2/projects/PROJECT_ID \
-H "Authorization: YOUR_API_KEY"
Τι μπορείτε να κάνετε
| Τομέας | Τι μπορεί να κάνει το λογισμικό σας | Πακέτα |
|---|---|---|
| Έργα και φάκελοι | Απαρίθμηση, ανάγνωση, δημιουργία, ενημέρωση και διαγραφή· ανάγνωση των μετρήσεων, των σχολίων και του αρχείου .mmp ενός έργου | Open Guest και Enterprise |
| Προϊόντα | Ανάγνωση, δημιουργία, ενημέρωση και αρχειοθέτηση των προϊόντων με τα οποία κοστολογείτε τη δουλειά σας | Open Guest και Enterprise |
| Έργα επισκεπτών | Ξεκινήστε ένα έργο επισκέπτη για έναν επισκέπτη, με τα στοιχεία του ήδη συμπληρωμένα | Open Guest |
| Μέλη | Δημιουργία, ανάγνωση, ενημέρωση και αφαίρεση των μελών του οργανισμού σας, και σύνδεσή τους | Enterprise |
| Ενσωματώσεις | Εμφανίστε ένα έργο ως ζωντανό χάρτη στον ιστότοπό σας | Enterprise |
| Webhooks | Λάβετε ένα υπογεγραμμένο μήνυμα στον διακομιστή σας όταν συμβαίνει κάτι | Open Guest και Enterprise |
Open Guest: οι επισκέπτες του ιστότοπού σας μετρούν μόνοι τους τη δουλειά τους
Οι επισκέπτες του ιστότοπού σας μετρούν μόνοι τους τη δουλειά τους, χωρίς λογαριασμό, βλέπουν την τιμή της καθώς σχεδιάζουν και σας στέλνουν αίτημα προσφοράς.
Πώς λειτουργεί
- Βάζετε τον σύνδεσμο επισκέπτη στον ιστότοπό σας, ως κουμπί ή ως χάρτη μέσα σε μια σελίδα.
- Ένας επισκέπτης τον ανοίγει, ή βρίσκει τη διεύθυνσή του στον χάρτη της σελίδας σας, και παίρνει δικό του έργο σε νέα καρτέλα, χωρίς καμία εγγραφή.
- Σχεδιάζει το γκαζόν, τη στέγη ή το δρομάκι του και βλέπει τις τιμές σας καθώς προχωράει.
- Πατά Αίτημα προσφοράς και αφήνει το όνομα, το email και το τηλέφωνό του.
- Λαμβάνετε ένα email και μια ειδοποίηση, και το έργο του βρίσκεται στον λογαριασμό σας.
Χωρίς κώδικα: αντιγράψτε τον σύνδεσμο επισκέπτη, ή τον κώδικα κουμπιού ή χάρτη γι' αυτόν, από το Προγραμματιστής > Σύνδεσμος επισκέπτη.
Πώς λειτουργεί το Open GuestΑπό τη δική σας φόρμα προσφοράς
Για να συμπληρώσει τα στοιχεία του επισκέπτη στη θέση του, ο διακομιστής σας ζητά ένα διακριτικό με το κλειδί Live και στέλνει τον επισκέπτη σε ένα νέο έργο επισκέπτη. Το κλειδί δεν φτάνει ποτέ στον περιηγητή.
// 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');
}
Η σελίδα Προγραμματιστής έχει αυτόν τον κώδικα έτοιμο για τον λογαριασμό σας, στην ενότητα Σύνδεσμος επισκέπτη > Open Guest API. Κάθε έργο επισκέπτη προσμετράται στη χρήση σας του Open Guest.
Enterprise: τα μέλη σας, από το δικό σας λογισμικό
Δημιουργήστε τα άτομα του οργανισμού σας από το δικό σας σύστημα, δώστε τους έργα και στείλτε τα στο Measure Map Online ήδη συνδεδεμένα.
Δημιουργήστε μέλη
Προσκαλέστε άτομα από τον πίνακα ελέγχου ή δημιουργήστε τα με το API. Κάθε μέλος καταλαμβάνει μία θέση και παίρνει τον προεπιλεγμένο ρόλο του οργανισμού σας.
POST /users/newΣυνδέστε τα με τις εγγραφές σας
Αποθηκεύστε το αναγνωριστικό χρήστη (uid) κάθε μέλους μαζί με τον πελάτη ή τον υπάλληλο στη βάση δεδομένων σας και διαβάστε τα στοιχεία του όποτε τα χρειάζεστε.
GET /users/{uid}Δημιουργήστε τα έργα τους
Δημιουργήστε ένα έργο στον λογαριασμό ενός μέλους και κρατήστε το αναγνωριστικό του μαζί με τη δουλειά στο δικό σας σύστημα.
POST /users/{uid}/projects/newΣυνδέστε τα
Ζητήστε ένα διακριτικό σύνδεσης και στείλτε το μέλος στην εφαρμογή με αυτό, ώστε να μη χρειάζεται ποτέ να μοιράσετε κωδικούς. Δεν είναι διαθέσιμο για Admins και Managers, ούτε με κλειδί Sandbox.
POST /auth/{uid}/login
https://app.measuremaponline.com/dashboard?sit=TOKENiFrame API: ένας ζωντανός χάρτης στον ιστότοπό σας
Εμφανίστε τον χάρτη ενός έργου, με τις μετρήσεις σας, μέσα στη δική σας ιστοσελίδα ή στο CRM σας. Οι επισκέπτες μπορούν να κινούνται σε αυτόν χωρίς λογαριασμό. Επιλέξτε τις μονάδες, τον τύπο χάρτη και φωτεινή ή σκούρα εμφάνιση.
Η σελίδα Προγραμματιστής φτιάχνει τον κώδικα για εσάς: επιλέξτε ένα έργο, ελέγξτε την ζωντανή προεπισκόπηση και αντιγράψτε τον. Οι ενσωματώσεις περιλαμβάνονται στο πακέτο Enterprise· στο Open Guest, ενσωματώστε αντί γι' αυτό τον σύνδεσμο επισκέπτη.
Οδηγός 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="Οι μετρήσεις της δουλειάς">
</iframe>
ms: metric ή imperial
· maptype: satellite, map, hybrid ή terrain
· theme: auto, light ή dark
Webhooks: μάθετε για τις αλλαγές
Προσθέστε τη διεύθυνση του διακομιστή σας στη σελίδα Προγραμματιστής και επιλέξτε τα συμβάντα που θέλετε. Κάθε συμβάν φτάνει ως POST με σώμα JSON, υπογεγραμμένο στην κεφαλίδα X-MMO-Signature, ώστε να ελέγξετε ότι προέρχεται από εμάς.
Τα webhooks περιλαμβάνονται στα πακέτα Open Guest και Enterprise.
Οδηγός webhooks| Συμβάν | Αποστέλλεται όταν |
|---|---|
project.created | Δημιουργείται ένα έργο, στην εφαρμογή, μέσω του API ή από μια ενσωμάτωση |
project.deleted | Ένα έργο διαγράφεται οριστικά (η μετακίνηση στον Κάδο δεν προσμετράται) |
project.comment.added | Κάποιος σχολιάζει ένα έργο |
guest.project.created | Ένας επισκέπτης ξεκινά ένα έργο επισκέπτη και η διεύθυνση email του είναι γνωστή, για παράδειγμα από τη φόρμα προσφοράς σας (Open Guest) |
guest.measurement.completed | Ένας επισκέπτης ολοκληρώνει τη μέτρηση και αφήνει τα στοιχεία επικοινωνίας του (Open Guest) |
budget.warning_reached,budget.limit_reached | Οι δαπάνες σας στο Open Guest φτάνουν στο όριο προειδοποίησης ή στο όριό σας |
enterprise.user.created | Προστίθεται μια θέση στον οργανισμό σας, και μέσω single sign-on (Enterprise) |