Authentication

การเรียกใช้ API Services ใดๆ ของ Vallaris Map จำเป็นต้องผ่านการยืนยันตัวตน ดังนั้นก่อนจะดำเนินการสร้างโปรเจค ผู้พัฒนาจำเป็นต้องมีบัญชีผู้ใช้ ซึ่งคุณสามารถสร้างบัญชีด้วย 3 แนวทางดังต่อไปนี้

• ลงทะเบียน (Register)
• ลงชื่อเข้าใช้ด้วยระบบ Single Sign-on (Google, Facebook, Apple)
• การสร้างบัญชีผู้ใช้โดยใช้ผู้ดูแลระบบ (Admin)

สร้างบัญชีผู้ใช้

การสร้างบัญชีผู้ใช้โดยใช้งาน API Services ซึ่งสามารถดำเนินการ 3 แนวทางคือ การลงทะเบียน, การเข้าสู่ระบบผ่านผู้ให้บริการภายนอก, และการถูกสร้างโดยผู้ดูแลระบบ

สร้างบัญชีด้วยการลงทะเบียน

การลงทะเบียน (Register) เพื่อสร้างบัญชีผู้ใช้ โดยสามารถลงทะเบียนโดยใช้อีเมล ซึ่งมีการเรียกใช้ API Services จำนวน 3 เส้นทาง (Path) ดังต่อไปนี้

1. Register : ลงทะเบียนการใช้งานระบบ
2. Send Email to Confirm : ส่งอีเมลยืนยันไปยังที่อยู่อีเมลที่ระบุ
3. Verify email : การยืนยันว่าที่อยู่อีเมลนั้นเป็นของคุณจริง และเป็นการยืนยันการสร้างบัญชีให้เสร็จสมบูรณ์

Order	Name	Method	Path
1	Register	POST	/managements/1.0/account/register
2	Send Email to Confirm	POST	/managements/1.0/email/confirm
3	Verify email	POST	/managements/1.0/email/verify

ตัวอย่างเรียกใช้ Register API

Javascript

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
const raw = JSON.stringify({
 accountType: "email",
 username: "[email protected]",
 password: "vallaris",
 email: "[email protected]",
 firstName: "Vallaris Maps",
 lastName: "Platform",
 extension: {
     organization: "i-bitz",
 },
});
const requestOptions = {
 method: "POST",
 headers: myHeaders,
 body: raw,
 redirect: "follow",
};

Python

import requests
import json
url = "https://va-cdn-02.vallarismaps.com/core/api/managements/1.0/account/register"
payload = json.dumps({
  "accountType": "email",
  "username": "[email protected]",
  "password": "vallaris",
  "email": "[email protected]",
  "firstName": "Vallaris Maps",
  "lastName": "Platform",
  "extension": {
      "organization": "i-bitz"
  }
})
headers = {
  'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers = headers, data = payload)
print(response.text)

ตัวอย่างเรียกใช้ Send Email to Confirm API

Javascript

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
const raw = JSON.stringify({
 redirect: "custom",
 email: "[email protected]",
 url:
     "/example/path/for/redirect",
});
const requestOptions = {
 method: "POST",
 headers: myHeaders,
 body: raw,
 redirect: "follow",
};
fetch(
 "https://va-cdn-02.vallarismaps.com/core/api/managements/1.0/email/confirm",
 requestOptions
)
 .then((response) => response.text())
 .then((result) => console.log(result))
 .catch((error) => console.error(error));

Python

import requests
import json
url = "https://va-cdn-02.vallarismaps.com/core/api/managements/1.0/email/confirm"
payload = json.dumps({
  "redirect": "custom",
  "email": "[email protected]",
  "url": "/example/path/for/redirect"
})
headers = {
  'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers = headers, data = payload)
print(response.text)

ตัวอย่างเรียกใช้ Verify email

Javascript

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
const raw = JSON.stringify({
 email: "[email protected]",
 code: "5cYqkOizmEueOfyooIDbQ7j9sukfpByMRO7UKxHtrC1YZXAOfgq6dtwFWKDsvoNJ",
});
const requestOptions = {
 method: "POST",
 headers: myHeaders,
 body: raw,
 redirect: "follow",
};
fetch(
 "https://va-cdn-02.vallarismaps.com/core/api/managements/1.0/email/verify",
 requestOptions
)
 .then((response) => response.text())
 .then((result) => console.log(result))
 .catch((error) => console.error(error));

Python

import requests
import json
url = "https://va-cdn-02.vallarismaps.com/core/api/managements/1.0/email/verify"
payload = json.dumps({
  "email": "[email protected]",
  "code": "5cYqkOizmEueOfyooIDbQ7j9sukfpByMRO7UKxHtrC1YZXAOfgq6dtwFWKDsvoNJ"
})
headers = {
  'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers = headers, data = payload)
print(response.text)