Hướng dẫn tích hợp đối tác API (Ứng dụng công cộng)

Để giúp các nhà tích hợp đối tác Wish API hiểu rõ hơn về tài liệu API Wish, những hành động nào có thể được thực hiện thông qua API so với trên Bảng điều khiển dành cho người bán và những tính năng nào quan trọng để hỗ trợ khi tích hợp với Wish, chúng tôi đã đề ra nội dung hướng dẫn sau đây để hướng dẫn đối tác API cách bắt đầu tạo ứng dụng công cộng thông qua API. Hãy làm theo từng bước:

 

1. Đăng ký ứng dụng công cộng trên môi trường hộp cát của Wish:

1). Đối tác đăng ký là ERP thông qua trang Đăng ký ERP trong môi trường hộp cát Wish. Đối tác có thể đánh giá hồ sơ API của Wish.

2). Đối tác gửi email đến Wish Partner API (partner-api@wish.com) để cho Wish biết rằng họ đã đăng ký quyền truy cập Partner API vào môi trường hộp cát Wish.

3). Wish sẽ phê duyệt ứng dụng của Đối tác.

4). Sau khi Đối tác được chấp thuận, Đối tác nên đăng nhập.

5). Nhấp vào Tài khoản > Tạo Ứng dụng.

Tạo tên ứng dụng (sử dụng tên mà bạn muốn người bán nhìn thấy). Cần có URL chuyển hướng cho OAuth (đó là nơi cho phép được gửi tới, bạn có thể thay đổi vào bất cứ lúc nào).

     Xin lưu ý rằng người bán sẽ không nhìn thấy các chi tiết ở trang nói trên trong Hộp cát. 

6). Đối tác sẽ được cung cấp ID khách hàng và bí mật khách hàng, những thông tin này sẽ được Đối tác sử dụng để kiểm tra tài khoản người bán trên hộp cát Wish (tiến trình Wish API OAuth trên hộp cát yêu cầu ID khách hàng và bí mật khách hàng).

 

2. Đối tác đăng nhập lần thứ hai vào Hộp cát với tư cách là người bán. Vì đây là môi trường hộp cát, nên thông tin người bán do Đối tác nhập vào không cần phải là thông tin của người bán thực tế.

1). Đối tác sẽ sử dụng một email khác với đăng ký ERP để đăng nhập vào Wish và bắt đầu phát triển ứng dụng công cộng với tư cách là người bán.

2). Liên kết tài khoản người bán giả với Đối tác ERP.

a). Khi đăng nhập với tư cách là người bán trong hộp cát, người bán nên thay đổi URL thành  https://sandbox.merchant.wish.com/v3/oauth/authorize?client_id={client_id} trong đó {client_id} là client_id mà ERP đã tạo khi họ tạo ứng dụng công cộng. Điều này sẽ hiển thị lời nhắc yêu cầu người bán cho phép cho ERP được quyền truy cập đầy đủ vào cửa hàng của người bán.

b). Khi người bán cho phép, URL sẽ thay đổi thành https://example.redirect.uri.com?code={authorization_code} và việc chuyển hướng lại được nêu rõ khi ERP tạo Ứng dụng công cộng.

c). Tại điểm này, các quy trình oAuth điển hình có thể được thực hiện theo

d). Tất cả các yêu cầu API nên bao gồm access_token. Mã truy cập có giá trị trong 30 ngày.

e). Để có mã truy cập mới, refresh_token có thể được sử dụng. Hành động này sẽ làm mất hiệu lực mã trước đó.

3). Đối tác sẽ thực hiện mọi kiểm tra trong môi trường hộp cát Wish.

4). Không yêu cầu chấp thuận thêm từ Wish để tiến hành

 

3. Đăng ký ứng dụng công cộng trên môi trường sản xuất của Wish

1). Đối tác đăng ký là ERP trong sản xuất thông qua trang Đăng ký ERP trong môi trường sản xuát Wish.

2). Đối tác gửi email đến Wish Partner API (partner-api@wish.com) để cho Wish biết rằng họ đã đăng ký quyền truy cập Partner API vào môi trường sản xuất Wish.

3). Wish sẽ phê duyệt ứng dụng của Đối tác hoặc thông báo cho Đối tác về vấn đề được xác định.

4). Sau khi được phê duyệt, bạn có thể đăng nhập và chọn Tài khoản > Tạo ứng dụng.

Đối tác nhập thông tin sẽ được công bố trên Wish App Store. Tên ứng dụng và URL chuyển hướng là các trường bắt buộc. Đối tác cũng có thể nhập thêm thông tin như logo ứng dụng, đề xuất giá trị, mô tả, trang web và/hoặc email hỗ trợ nhưng cần phải trải qua quá trình xem xét vì chúng sẽ hiển thị cho người bán.

Nếu thông tin bổ sung này được nhập, ứng dụng sẽ vẫn được tạo và có thể tích hợp với API, tuy nhiên, các trường này sẽ chỉ được công bố trên Wish App Store sau khi chúng được phê duyệt. Trong khi đó, trạng thái phê duyệt của các trường thông tin bổ sung này có thể được xem như hiển thị bên dưới.

Bạn có thể xem và chỉnh sửa tất cả thông tin đã gửi ở trên (bắt buộc hoặc bổ sung) bằng cách vào Tài khoản > Cài đặt ứng dụng. Nếu chi tiết trong các trường thông tin bổ sung được chỉnh sửa hoặc xóa, chúng sẽ cần phải trải qua quá trình xem xét lại.

5). Xem lại tài liệu môi trường Sản xuất Wish API

6). Đối tác hoàn thành quy trình OAuth.

7). Các đối tác cần bật tính năng tích hợp của họ trong môi trường sản xuất Wish và nhớ trỏ các lệnh gọi API đến môi trường sản xuất Wish thay vì môi trường hộp cát.

 

4. Người bán phải đăng ký tài khoản cửa hàng duy nhất trên Bảng điều khiển dành cho người bán Wish và cho phép ERP gửi/nhận dữ liệu đến/từ cửa hàng Wish của người bán. 

1). Là một phần của quy trình đăng ký tài khoản người bán, người bán cần gửi thông tin xác minh giấy phép kinh doanh và ID thông tin cá nhân, sẽ được Wish chấp thuận.

2). Tài khoản Người bán sẽ được đại diện người quản lý tài khoản Wish chấp thuận.

3). Sau đó người bán cần cho phép ERP thông qua các phương pháp sau: 

a). Người bán đăng ký tài khoản tại ERP tùy họ chọn.

(i) Người bán chọn đường liên kết cho phép Wish từ giao diện ERP để chuyển họ đến lại trang Cho phép OAuth, mà họ có thể cho phép ERP.

• Đường liên kết nên như sau với ID khách hàng sản xuất duy nhất của ERP: https://merchant.wish.com/v3/oauth/authorize?client_id={PRODUCTION_CLIENT_ID}

(ii) Người bán nhấp vào "Cho phép" để chuyển hướng họ đến "Chuyển hướng URI" được nêu rõ bởi ERP với mã cho phép. ERP sẽ sử dụng mã cho phép này để gọi Wish API và nhận mã truy cập.

b). Người bán tìm hiểu ERP trên App Store của Wish (LƯU Ý: quy trình này chưa được khởi chạy, nhưng ERP sẽ có thể xử lý quy trình này để chuẩn bị khởi chạy trong tương lai):

(i) Người bán chọn "Thêm ứng dụng" để chuyển họ đến lại trang Cho phép OAuth, mà họ có thể cho phép ERP.

(ii) Người bán nhấp vào "Cho phép" để chuyển hướng họ đến "Chuyển hướng URI" được nêu rõ bởi ERP với mã cho phép. ERP sẽ sử dụng mã cho phép này để gọi Wish API và nhận mã truy cập.

• Kết nối có thể không hoàn tất nếu trang "Chuyển hướng URI" được nêu rõ bởi ERP không thể xử lý trường hợp người bán không đăng nhập và/hoặc không có tài khoản với ERP.

• Để hoàn tất kết nối, nhắc người bán đăng nhập hoặc đăng ký ERP của bạn. Sau đó chuyển tiếp mã cho phép trong url và hoàn tất quy trình OAuth sau khi người bán đăng nhập hoặc đã tạo tài khoản.

c) Lúc này cho phép đã hoàn tất.

d). Nếu vào bất kỳ thời điểm nào mà người bán dự kiến hủy cho phép ERP, người bán có thể làm điều này từ Bảng điều khiển dành cho người bán Wish tại Tài khoản > Cài đặt > Cài đặt API.

 

Xin lưu ý để cải thiện tính an ninh cho các ứng dụng công cộng, nay các đối tác có thể thêm đến 2 bí mật khách hàng OAuth cho ứng dụng công cộng của họ. Chỉ cần đến trang Cài đặt ứng dụng của bạn và nhấp vào “Thêm khóa thứ hai” trong bí mật khách hàng đầu tiên để thêm bí mật thứ hai:

Nếu cần, các đối tác cũng có thể luân phiên 2 bí mật khách bằng cách xóa một bí mật và thêm một bí mật mới, trong trường hợp bí mật khách hàng của họ đã bị xâm phạm.

 

Lưu ý: Để biết các đường liên kết đến tài liệu, gợi ý, hướng dẫn và nhiều hơn nữa, xem Trang người phát triển Wish.