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 |
| Webhook | รับข้อความที่มีลายเซ็นบนเซิร์ฟเวอร์ของคุณเมื่อมีเหตุการณ์เกิดขึ้น | Open GuestและEnterprise |
Open Guest: ผู้เข้าชมเว็บไซต์ของคุณวัดงานของตัวเอง
ผู้เข้าชมเว็บไซต์ของคุณวัดงานของตัวเองโดยไม่ต้องมีบัญชี เห็นราคาขณะวาด และส่งคำขอใบเสนอราคามาให้คุณ
ทำงานอย่างไร
- คุณวางลิงก์ผู้เยี่ยมชมบนเว็บไซต์ ทั้งแบบปุ่มหรือแผนที่ฝังในหน้าเว็บ
- ผู้เข้าชมเปิดลิงก์ หรือค้นหาที่อยู่ของตัวเองบนแผนที่ในหน้าเว็บของคุณ แล้วได้โปรเจกต์ของตัวเองในแท็บใหม่ทันที โดยไม่ต้องสมัครอะไร
- พวกเขาวาดสนามหญ้า หลังคา หรือทางเข้าบ้านของตัวเอง และเห็นราคาของคุณไปพร้อมกัน
- พวกเขากด ขอใบเสนอราคา และกรอกชื่อ อีเมล และเบอร์โทร
- คุณจะได้รับอีเมลและการแจ้งเตือน และโปรเจกต์ของพวกเขาจะอยู่ในบัญชีของคุณ
ไม่ต้องเขียนโค้ด: คัดลอกลิงก์ผู้เยี่ยมชม หรือโค้ดปุ่มหรือแผนที่ของลิงก์นั้น จาก นักพัฒนา > ลิงก์ผู้เยี่ยมชม
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เชื่อมกับระเบียนของคุณ
เก็บ ID ผู้ใช้ (uid) ของสมาชิกแต่ละคนไว้กับลูกค้าหรือพนักงานในฐานข้อมูลของคุณ และอ่านรายละเอียดของพวกเขาเมื่อต้องการ
GET /users/{uid}สร้างโปรเจกต์ให้พวกเขา
สร้างโปรเจกต์ในบัญชีของสมาชิก และเก็บ ID ของมันไว้กับงานในระบบของคุณเอง
POST /users/{uid}/projects/newลงชื่อเข้าใช้ให้พวกเขา
ขอโทเค็นลงชื่อเข้าใช้และส่งสมาชิกเข้าแอปพร้อมโทเค็นนั้น คุณจึงไม่ต้องแจกรหัสผ่านเลย ใช้ไม่ได้กับ Admin และ Manager หรือกับคีย์ 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
Webhook: รับรู้การเปลี่ยนแปลง
เพิ่มที่อยู่เซิร์ฟเวอร์ของคุณในหน้านักพัฒนาและเลือกเหตุการณ์ที่ต้องการ แต่ละเหตุการณ์จะมาในรูป POST พร้อมเนื้อหา JSON ที่ลงลายเซ็นไว้ในส่วนหัว X-MMO-Signature เพื่อให้คุณตรวจสอบได้ว่ามาจากเราจริง
Webhook เป็นส่วนหนึ่งของแพ็กเกจ Open Guest และ Enterprise
คู่มือ Webhook| เหตุการณ์ | ส่งเมื่อ |
|---|---|
project.created | มีการสร้างโปรเจกต์ ในแอป ผ่าน API หรือจากแผนที่ที่ฝัง |
project.deleted | โปรเจกต์ถูกลบถาวร (การย้ายไปที่ถังขยะไม่นับ) |
project.comment.added | มีคนแสดงความคิดเห็นในโปรเจกต์ |
guest.project.created | ผู้เข้าชมเริ่มโปรเจกต์ผู้เยี่ยมชมและทราบที่อยู่อีเมลของเขา เช่น จากแบบฟอร์มขอใบเสนอราคาของคุณ (Open Guest) |
guest.measurement.completed | ผู้เข้าชมวัดเสร็จและทิ้งข้อมูลติดต่อไว้ (Open Guest) |
budget.warning_reached,budget.limit_reached | ค่าใช้จ่าย Open Guest ของคุณถึงระดับเตือนหรือวงเงินสูงสุด |
enterprise.user.created | มีการเพิ่มที่นั่งในองค์กรของคุณ รวมถึงผ่านการลงชื่อเข้าใช้ครั้งเดียว (Enterprise) |