ขั้นตอนจนถึงเริ่มใช้งาน
อธิบายขั้นตอนจนถึงเริ่มใช้พอร์ทัลนักพัฒนาของ ReceiptRoller หากลงทะเบียนเป็นผู้ใช้ร้านค้าและเป็นแพลน Starter ขึ้นไป ก็ไม่จำเป็นต้องยื่นคำขอเป็นนักพัฒนาต่างหาก เพียงลงทะเบียนแอปก็เริ่มพัฒนา API ได้ทันที
ขั้นตอนจนถึงเริ่มใช้งาน
พอร์ทัลนักพัฒนาของ ReceiptRoller ไม่ใช่「ไซต์เฉพาะนักพัฒนา」แยกโดเมนต่างหาก แต่ให้บริการในฐานะหนึ่งในฟีเจอร์ภายในหน้าจัดการร้านค้าปกติ ด้วยเหตุนี้ โดยหลักการจึงไม่มีโฟลว์แยกต่างหากแบบ「ยื่นคำขอเป็นนักพัฒนาแล้วรอการอนุมัติ」เพียงลงทะเบียนเป็นผู้ใช้ร้านค้าและอัปเกรดแพลน ฟีเจอร์นักพัฒนาก็ใช้ได้ตั้งแต่จุดนั้น
ภาพรวมใน 3 นาที
- ลงทะเบียนเป็นผู้ใช้ร้านค้า — เหมือนการสร้างบัญชีร้านค้าปกติ
- อัปเกรดแพลนเป็น Starter ขึ้นไป — แพลนฟรีใช้ API นักพัฒนาไม่ได้
- ลงทะเบียนแอปในพอร์ทัลนักพัฒนา — ออก client ID・secret
- ทำโฟลว์อนุญาต OAuth — ระบุ scope ที่จำเป็นและขอ token
- พัฒนาด้วย API หรือ Webhook
เฉพาะกรณีจัดการข้อมูลใบเสร็จ・รายจ่ายของผู้ใช้ส่วนบุคคล (scope user.*) เท่านั้นที่จะต้องมีการตรวจสอบล่วงหน้าเพิ่มเติม รายละเอียดโปรดดูท้ายหน้านี้และ รายการ OAuth scope
ขั้นตอนที่ 1:ลงทะเบียนเป็นผู้ใช้ร้านค้า
สร้างบัญชีร้านค้าปกติของ ReceiptRoller หากใช้งานเป็นผู้ใช้ร้านค้าอยู่แล้ว ให้ข้ามขั้นตอนนี้ได้
- เลือก「เริ่มใช้ฟรี」จากหน้ารวมของ ReceiptRoller แล้วกรอกอีเมล・รหัสผ่าน・ข้อมูลบัญชีธุรกิจ
- ลงทะเบียนร้านค้าตั้งแต่ 1 ร้านขึ้นไป (เพราะขอบเขตการเชื่อมต่อ API คือ「บัญชีธุรกิจ」และ「ร้านค้า」)
- ณ จุดที่ลงทะเบียนจะเป็นแพลนฟรี
รายละเอียดการสร้างบัญชีร้านค้าดูที่ การสร้างบัญชีร้านค้า (Help สำหรับร้านค้า)
ขั้นตอนที่ 2:อัปเกรดแพลนเป็น Starter ขึ้นไป
API นักพัฒนาใช้ได้ตั้งแต่แพลน Starter ขึ้นไป ในแพลนฟรีจะไม่สามารถเข้าถึงหน้าลงทะเบียนแอปเพื่อสร้างได้แม้จะเปิดเข้าไป
- เปิด เมนูบัญชีธุรกิจ > ตั้งค่าบัญชีธุรกิจ > แพลน・การเรียกเก็บเงิน
- เลือกแพลน Starter ขึ้นไปจาก「อัปเกรด」และทำขั้นตอนการทำสัญญาให้เสร็จ
- พอร์ทัลนักพัฒนาจะเปิดใช้ได้พร้อมกับการทำสัญญาเสร็จสิ้น
ฟีเจอร์ที่ใช้ได้ในแต่ละแพลนดูที่ ความสัมพันธ์ระหว่างแพลนและบทบาท
ขั้นตอนที่ 3:ลงทะเบียนแอปในพอร์ทัลนักพัฒนา
เปิดพอร์ทัลนักพัฒนาจากเมนูของหน้าจัดการร้านค้า แล้วลงทะเบียนแอปพลิเคชันใหม่
- เปิด「Developer Portal」หรือ「พอร์ทัลนักพัฒนา」จากเมนูของหน้าจัดการร้านค้า
- คลิก「ลงทะเบียนแอป」หรือ「สร้างแอปใหม่」
- กรอกข้อมูลต่อไปนี้:
- ชื่อแอป — ชื่อที่แสดงให้ผู้ใช้เห็นในหน้าอนุญาต
- redirect URI — URL ปลายทางที่คืน code หลังการอนุญาต OAuth (ลงทะเบียนได้หลายรายการ)
- scope ที่จำเป็น — OAuth scope ที่แอปนี้ร้องขอ
- เมื่อลงทะเบียนแล้ว client ID และ client secret จะถูกออก
โปรดคัดลอกและเก็บไว้ในที่ปลอดภัยเสมอ หากทำหายจะต้องสร้างใหม่ (secret เดิมจะใช้ไม่ได้ทันที)
ขั้นตอนที่ 4:ตั้งค่า OAuth scope
ระบุ scope ขั้นต่ำที่แอปต้องการ รายการ scope ฉบับสมบูรณ์และข้อจำกัดการดึงข้อมูลดูที่ รายการ OAuth scope และการใช้ได้/ไม่ได้
- เฉพาะ scope กลุ่ม Store (
store.*/crm.*/sns.*/analytics.*) → ใช้ได้พร้…
-
ข้อมูลด้านต่าง ๆ ที่ใช้ได้อธิบายข้อมูลด้านต่าง ๆ ที่ดึงได้จากพอร์ทัลนักพัฒนาของ ReceiptRoller เป็นรายการ รวบรวมเนื้อหาที่อยู่ในแต่ละด้าน วิธีดึง และ scope ที่จำเป็น ครอบคลุมการซื้อ・สินค้า・สินค้าคงคลัง・คำสั่งซื้อ・ลูกค้า・คูปอง・SNS・โฆษณา・ข้อมูลผู้ใช้ส่วนบุคคล ฯลฯ
-
สิ่งที่ทำได้ด้วยพอร์ทัลนักพัฒนาภาพรวมของสิ่งที่ทำได้ด้วยพอร์ทัลนักพัฒนาของ ReceiptRoller ผสมผสานการดึงและจัดการข้อมูลผ่าน REST API กับการรับอีเวนต์แบบเรียลไทม์ผ่าน Webhook เพื่อเชื่อมต่อข้อมูลร้านค้าและผู้ใช้จากระบบภายนอก
-
การลงทะเบียนแอปพลิเคชันคืออะไรอธิบายแนวคิดของการลงทะเบียนแอปพลิเคชันใน ReceiptRoller การลงทะเบียนแอปในฐานะ OAuth client จะทำให้ได้ client ID・secret・redirect URI และเริ่มการเชื่อมต่อ API・Webhook ได้