คู่มือสำหรับการรวมระบบพันธมิตร API (แอปสาธารณะ)

เพื่อช่วยให้ผู้รวมระบบพันธมิตร API ของ Wish เข้าใจ เอกสารประกอบ Wish API ดียิ่งขึ้น เกี่ยวกับสิ่งที่ดำเนินการผ่าน API ได้เมื่อเปรียบเทียบกับแดชบอร์ดผู้ขาย และฟีเจอร์ใดที่มีความสำคัญต่อการสนับสนุนเมื่อสร้างการรวมเข้ากับ Wish เราได้สร้างคู่มือต่อไปนี้เพื่อให้พันธมิตร API ทราบถึงวิธีการเริ่มต้นในการสร้างแอปสาธารณะผ่าน API โปรดปฏิบัติตามขั้นตอนดังนี้:

1. ลงทะเบียนใช้แอปสาธารณะในสภาพแวดล้อม Sandbox ของ Wish:

1). คู่ค้าลงทะเบียนเป็น ERP ผ่านทางหน้าลงทะเบียน ERP บนสภาพแวดล้อมแซนด์บ็อกซ์ของ Wish ทั้งนี้คู่ค้าสามารถตรวจสอบคู่มือ API ของ Wish ได้

2). ให้พันธมิตรส่งอีเมลไปยังอีเมล API พันธมิตรของ Wish (partner-api@wish.com) เพื่อให้ Wish ทราบว่าพันธมิตรลงทะเบียนใช้การเข้าถึง API ของพันธมิตรไปยังสภาพแวดล้อม Sandbox แล้ว

3). Wish จะอนุมัติแอปพลิเคชันของพันธมิตร

4). เมื่อพันธมิตรได้รับการอนุมัติ พันธมิตรควรลงชื่อเข้าสู่ระบบ

5). คลิกบัญชี > สร้างแอป

ตั้งชื่อแอป (ใช้ชื่อที่คุณต้องการให้ผู้ค้าเห็น) จำเป็นต้องเปลี่ยนเส้นทาง URL ให้กับ OAuth (เป็นที่ซึ่งจะส่งการอนุญาตไป คุณสามารถเปลี่ยนได้ตลอดเวลา)

โปรดทราบว่าผู้ค้าจะไม่เห็นรายละเอียดที่หน้าด้านบนใน Sandbox

6). พันธมิตรจะได้รับ ID ลูกค้าและความลับของลูกค้าที่พันธมิตรจะใช้ทำการทดสอบบัญชีผู้ค้าบน Sandbox ของ Wish (ขั้นตอน Wish API OAuth บน Sandbox ต้องใช้ ID ลูกค้าและความลับของลูกค้า)

2. ให้พันธมิตรเข้าสู่ระบบครั้งที่สองใน Sandbox ในฐานะผู้ค้า เนื่องจากเป็นสภาพแวดล้อม Sandbox ข้อมูลผู้ค้าที่พันธมิตรป้อนไม่จำเป็นต้องเป็นข้อมูลจริงของผู้ค้า

1). ให้พันธมิตรใช้อีเมลอื่นจากการลงทะเบียน ERP เพื่อลงชื่อเข้าสู่ระบบ Wish และเริ่มการพัฒนาแอปสาธารณะในฐานะผู้ค้า

2). เชื่อมโยงบัญชีผู้ค้าปลอมกับพันธมิตร ERP

a). เมื่อเข้าสู่ระบบในฐานะผู้ค้าใน Sandbox ผู้ค้าควรเปลี่ยน URL เป็น https://sandbox.merchant.wish.com/v3/oauth/authorize?client_id={client_id} โดย {client_id} เป็น ID ลูกค้า ที่ ERP สร้างขึ้นเมื่อสร้างแอปสาธารณะ ซึ่งจะทริกเกอร์ข้อความแจ้งที่ขอให้ผู้ค้าอนุญาต ERP มีสิทธิ์เข้าถึงร้านค้าของผู้ค้าอย่างเต็มที่

b). เมื่อผู้ค้าอนุญาตสิทธิ์ URL จะเปลี่ยนเป็น https://example.redirect.uri.com?code={authorization_code} ซึ่งระบุการเปลี่ยนเส้นทางเมื่อ ERP สร้างแอปสาธารณะ

c). เมื่อมาถึงขั้นตอนนี้ สามารถปฏิบัติตามกระบวนการ OAuth ตามปกติได้

d). คำขอ API ทั้งหมดควรมี access_token โทเค็นการเข้าถึงใช้งานได้เป็นเวลา 30 วัน

e). หากต้องการรับโทเค็นการเข้าถึงใหม่ สามารถใช้ refresh_token ได้ ซึ่งจะทำให้โทเค็นก่อนหน้าใช้งานไม่ได้

3). พันธมิตรจะดำเนินการทดสอบทั้งหมดในสภาพแวดล้อม Sandbox ของ Wish

4). ไม่จำเป็นต้องมีการอนุมัติเพิ่มเติมจาก Wish เพื่อดำเนินการ

3. ลงทะเบียนใช้แอปสาธารณะในสภาพแวดล้อมการผลิตของ Wish

1). คู่ค้าลงทะเบียนเป็น ERP ในการผลิตผ่านทางหน้าลงทะเบียน ERP บนสภาพแวดล้อมการผลิตของ Wish

3). Wish จะอนุมัติแอปพลิเคชันของพันธมิตร หรือแจ้งเตือนพันธมิตรเกี่ยวกับปัญหาที่ระบุ

4). เมื่ออนุมัติแล้ว คุณสามารถเข้าสู่ระบบและเลือกบัญชี > สร้างแอป

พันธมิตรป้อนข้อมูลที่จะเผยแพร่ลงใน Wish App Store ชื่อแอปและการเปลี่ยนเส้นทาง URL คือช่องที่ต้องกรอก พันธมิตรสามารถป้อนข้อมูลเพิ่มเติม เช่น โลโก้แอป มูลค่าที่เสนอ คำอธิบาย เว็บไซต์ และ/หรืออีเมลการสนับสนุน ซึ่งจำเป็นต้องผ่านกระบวนการตรวจสอบเนื่องจากจะแสดงให้ผู้ค้าเห็น

หากป้อนข้อมูลเพิ่มเติมแล้ว แอปจะยังคงมีการสร้างขึ้นและสามารถผสานรวมกับ API ได้ แต่ข้อมูลในฟิลด์เหล่านี้จะเผยแพร่ใน Wish App Store เมื่อมีการอนุมัติแล้วเท่านั้น ระหว่างนี้ สามารถดูสถานะการอนุมัติของฟิลด์ข้อมูลเพิ่มเติมได้ที่ด้านล่าง

คุณสามารถดูและแก้ไขข้อมูลทั้งหมดที่ส่งด้านบน (ทั้งข้อมูลที่จำเป็นและข้อมูลเพิ่มเติม) ได้โดยไปที่บัญชี > การตั้งค่าแอป หากรายละเอียดในฟิลด์ข้อมูลเพิ่มเติมมีการแก้ไขหรือถูกลบ ข้อมูลดังกล่าวจะต้องผ่านกระบวนการตรวจสอบอีกครั้ง

5). ตรวจสอบเอกสารประกอบของ API สภาพแวดล้อมการผลิต Wish

6). พันธมิตรดำเนินกระบวนการ OAuth ให้เสร็จสิ้น

7). พันธมิตรต้องเปิดการผสานรวมของตนในสภาพแวดล้อมการผลิต Wish และไม่ลืมที่จะแสดงการเรียก API ให้กับสภาพแวดล้อมการผลิต Wish แทนที่จะเป็นสภาพแวดล้อม Sandbox

4. ผู้ค้าต้องลงทะเบียนบัญชีร้านค้าที่ไม่ซ้ำกันในแดชบอร์ดผู้ขายของ Wish และอนุญาตให้ ERP ส่ง/รับข้อมูลไปยัง/จากร้านค้า Wish ของผู้ค้า

1). ในการลงทะเบียนบัญชีผู้ค้า ผู้ค้าจะต้องส่งข้อมูลใบอนุญาตประกอบธุรกิจที่ถูกต้องและ ID ข้อมูลส่วนบุคคล ซึ่ง Wish จะเป็นผู้อนุมัติ

2). ตัวแทนผู้จัดการบัญชีของ Wish จะเป็นผู้อนุมัติบัญชีผู้ค้า

3). ผู้ค้าจำเป็นต้องอนุญาต ERP ด้วยวิธีการอย่างใดอย่างหนึ่งต่อไปนี้:

a). ให้ผู้ค้าลงทะเบียนบัญชีใน ERP ที่ตนเลือก

(i) ให้ผู้ค้าเลือกลิงก์การอนุญาตของ Wish จากอินเทอร์เฟซ ERP เพื่อเปลี่ยนเส้นทางไปยังหน้าการอนุญาต OAuth ซึ่งจะอนุญาต ERP ได้

• ลิงก์จะปรากฏดังนี้ โดยมี ID ลูกค้าการผลิต ERP ที่ไม่ซ้ำกัน https://merchant.wish.com/v3/oauth/authorize?client_id={{PRODUCTION_CLIENT_ID}

(ii) ให้ผู้ค้าคลิก ‘อนุญาต’ เพื่อเปลี่ยนเส้นทางไปยัง ERP ที่ระบุว่า "เปลี่ยนเส้นทาง URI" ที่มีรหัสการอนุญาต ERP จะใช้รหัสการอนุญาตนี้เพื่อเรียกใช้ API ของ Wish เพื่อรับโทเค็นการเข้าถึง

b). ผู้ค้าค้นพบ ERP ใน Wish App Store (หมายเหตุ: กระบวนการนี้ยังไม่เปิดใช้งาน แต่ ERP ควรจะจัดการกระบวนการนี้ได้เพื่อเตรียมการสำหรับการเปิดใช้งานในอนาคต):

(i) ให้ผู้ค้าเลือก ‘เพิ่มแอป’ เพื่อเปลี่ยนเส้นทางไปยังหน้าการอนุญาต OAuth ซึ่งจะอนุญาต ERP ได้

• การเชื่อมต่ออาจไม่สมบูรณ์หากหน้า ERP ที่ระบุว่า "เปลี่ยนเส้นทาง URI" ไม่สามารถจัดการกับกรณีที่ผู้ค้าไม่ลงชื่อเข้าสู่ระบบ และ/หรือไม่มีบัญชีที่มี ERP

• หากต้องการให้การเชื่อมต่อสมบูรณ์ โปรดเตือนให้ผู้ค้าเข้าสู่ระบบหรือลงทะเบียน ERP ของคุณ จากนั้นนำรหัสการอนุญาตไปไว้ที่ url และดำเนินกระบวนการ OAuth ให้เสร็จสิ้นเมื่อผู้ค้าเข้าสู่ระบบหรือสร้างบัญชีแล้ว

c). การอนุญาตสมบูรณ์แล้ว

d). หากผู้ค้าต้องการยกเลิกการอนุญาต ERP เมื่อใด ผู้ค้าสามารถยกเลิกได้จากแดชบอร์ดผู้ขายของ Wish ที่บัญชี > การตั้งค่า > การตั้งค่า API

โปรดทราบว่าเพื่อปรับปรุงความปลอดภัยสำหรับแอปสาธารณะ พันธมิตรสามารถเพิ่มความลับของลูกค้า OAuth ได้สูงสุด 2 รายการสำหรับแอปสาธารณะของตนได้แล้ว เพียงนำทางไปยังหน้าการตั้งค่าแอป แล้วคลิก "เพิ่มคีย์ที่สอง" ภายใต้ความลับลูกค้ารายแรกเพื่อเพิ่มรายการที่สอง:

หากจำเป็น พันธมิตรอาจหมุนเวียนความลับของลูกค้า 2 รายโดยการลบหนึ่งรายการแล้วเพิ่มความลับใหม่ ในกรณีที่ความลับของลูกค้ารั่วไหล

หมายเหตุ: สำหรับลิงก์ไปยังเอกสารประกอบ เคล็ดลับ บทช่วยสอน และอื่นๆ โปรดดูที่หน้านักพัฒนาของ Wish

บทความในส่วนนี้

ข้อคิดเห็น

บทความในส่วนนี้

บทความที่เกี่ยวข้อง