ข้ามไปยังเนื้อหา

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: ผู้เข้าชมเว็บไซต์ของคุณวัดงานของตัวเอง

ผู้เข้าชมเว็บไซต์ของคุณวัดงานของตัวเองโดยไม่ต้องมีบัญชี เห็นราคาขณะวาด และส่งคำขอใบเสนอราคามาให้คุณ

ทำงานอย่างไร

  1. คุณวางลิงก์ผู้เยี่ยมชมบนเว็บไซต์ ทั้งแบบปุ่มหรือแผนที่ฝังในหน้าเว็บ
  2. ผู้เข้าชมเปิดลิงก์ หรือค้นหาที่อยู่ของตัวเองบนแผนที่ในหน้าเว็บของคุณ แล้วได้โปรเจกต์ของตัวเองในแท็บใหม่ทันที โดยไม่ต้องสมัครอะไร
  3. พวกเขาวาดสนามหญ้า หลังคา หรือทางเข้าบ้านของตัวเอง และเห็นราคาของคุณไปพร้อมกัน
  4. พวกเขากด ขอใบเสนอราคา และกรอกชื่อ อีเมล และเบอร์โทร
  5. คุณจะได้รับอีเมลและการแจ้งเตือน และโปรเจกต์ของพวกเขาจะอยู่ในบัญชีของคุณ

ไม่ต้องเขียนโค้ด: คัดลอกลิงก์ผู้เยี่ยมชม หรือโค้ดปุ่มหรือแผนที่ของลิงก์นั้น จาก นักพัฒนา > ลิงก์ผู้เยี่ยมชม

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

ตัวอย่าง: โปรเจกต์ในหน้าเว็บของคุณเอง

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)