Μετάβαση στο περιεχόμενο

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: οι επισκέπτες του ιστότοπού σας μετρούν μόνοι τους τη δουλειά τους

Οι επισκέπτες του ιστότοπού σας μετρούν μόνοι τους τη δουλειά τους, χωρίς λογαριασμό, βλέπουν την τιμή της καθώς σχεδιάζουν και σας στέλνουν αίτημα προσφοράς.

Πώς λειτουργεί

  1. Βάζετε τον σύνδεσμο επισκέπτη στον ιστότοπό σας, ως κουμπί ή ως χάρτη μέσα σε μια σελίδα.
  2. Ένας επισκέπτης τον ανοίγει, ή βρίσκει τη διεύθυνσή του στον χάρτη της σελίδας σας, και παίρνει δικό του έργο σε νέα καρτέλα, χωρίς καμία εγγραφή.
  3. Σχεδιάζει το γκαζόν, τη στέγη ή το δρομάκι του και βλέπει τις τιμές σας καθώς προχωράει.
  4. Πατά Αίτημα προσφοράς και αφήνει το όνομα, το email και το τηλέφωνό του.
  5. Λαμβάνετε ένα 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=TOKEN

iFrame 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)