Tạo Ứng Dụng Riêng Tư với SHOPLINE Develop Apps

Phát triển Ứng dụng là một khung ứng dụng được tạo ra đặc biệt cho cửa hàng SHOPLINE của bạn, bởi bạn hoặc bởi một nhà phát triển bên ngoài. Khác với các ứng dụng công cộng được thiết kế cho nhiều cửa hàng, Phát triển Ứng dụng là riêng tư và được điều chỉnh theo nhu cầu độc đáo của cửa hàng của bạn.

Với Phát triển Ứng dụng, bạn có thể truy cập dữ liệu cửa hàng của mình một cách an toàn thông qua SHOPLINE Admin API hoặc mở rộng khả năng cửa hàng của bạn đến các nền tảng bên ngoài bằng cách sử dụng Storefront API. Mỗi ứng dụng đi kèm với API Key và App Secret riêng, xác định ứng dụng của bạn, cũng như API access tokens cho phép các yêu cầu API dựa trên các quyền mà bạn cấu hình.

Bằng cách tạo và quản lý các thông tin xác thực API này, bạn có thể tích hợp dữ liệu SHOPLINE vào các hệ thống nội bộ của mình, tự động hóa quy trình làm việc, hoặc xây dựng các tính năng tùy chỉnh hỗ trợ hoạt động kinh doanh của bạn. Nếu bạn dự định phát triển một ứng dụng tùy chỉnh—dù độc lập hay với sự trợ giúp của các nhà phát triển—để đáp ứng các yêu cầu kinh doanh ngày càng tăng, Phát triển Ứng dụng cung cấp sự linh hoạt và kiểm soát cần thiết để thực hiện điều đó một cách an toàn.

Cấu hình Quyền Quản lý Ứng dụng

Trước khi tạo một ứng dụng riêng tư, hãy đảm bảo bạn có quyền Quản lý Ứng dụng Riêng tư. Các quản lý cửa hàng tự động có quyền truy cập đầy đủ vào phát triển ứng dụng.

Là một quản lý cửa hàng, bạn có thể cấp quyền phát triển ứng dụng cho nhân viên của mình, chẳng hạn như xem hoặc chỉnh sửa các ứng dụng riêng tư.

Để thiết lập quyền cho nhân viên:

1. Đăng nhập vào SHOPLINE Admin, đi đến Cài đặt, và nhấp vào Nhân viên và quyền.

2. Tìm thành viên nhân viên mà bạn muốn cấp quyền, và nhấp vào biểu tượng bút chì trong cột Hành động.

3. Dưới Quản lý quyền, đánh dấu vào Quản lý ứng dụng riêng tư và nhấp vào Cập nhật để lưu.

   

Tạo một Ứng dụng

Đăng nhập vào SHOPLINE admin > Ứng dụng > Phát triển Ứng dụng ở góc trên bên phải. 

Đọc và đánh dấu vào ô nếu bạn đồng ý với 《quyền API và điều khoản》 sử dụng nhấp vào Bật phát triển.

Nhấp vào Tạo một Ứng dụng và nhập Tên ứng dụng, Nhà phát triển ứng dụng, và Địa chỉ email liên hệ của ứng dụng, sau đó nhấp vào Tạo một Ứng dụng. 

Cấu hình Quyền Admin API

Nhấp vào Chỉnh sửa > Thẻ cấu hình quyền > nút Cấu hình của tùy chọn Tích hợp Admin API. 

Nhập trang Phạm vi truy cập của Admin API và thiết lập phạm vi truy cập, tạo một Webhook, và nhấn Lưu. 

Cấu hình Quyền Truy cập Storefront API

Nhấp vào Chỉnh sửa để vào trang chi tiết ứng dụng, chọn thẻ Cấu hình quyền, và nhấp vào Cấu hình cho Tích hợp store API.

Nhập trang chỉnh sửa quyền store API, đánh dấu vào tùy chọn để thiết lập quyền truy cập API, và nhấp vào Lưu.

Truy cập API Keys và Tạo API Tokens

Để truy cập thông tin xác thực API của bạn, hãy đi đến thẻ Chứng chỉ API. Trang này hiển thị các chứng chỉ API của bạn và các mã thông báo truy cập được tạo dựa trên cấu hình quyền của bạn.

Chứng chỉ API

Dưới thẻ Chứng chỉ API, bạn sẽ tìm thấy hai thông tin xác thực thiết yếu trong phần Chứng chỉ API:

• API Key: Định danh duy nhất cho ứng dụng của bạn.

• App Secret: Khóa riêng được sử dụng để ký các yêu cầu API một cách an toàn.

Các giá trị này được tạo tự động khi ứng dụng được tạo ra. App Secret được ẩn để bảo mật và có thể được sao chép khi cần thiết.

Tạo Mã Truy Cập API

Sau khi cấu hình quyền Admin API và/hoặc Storefront API, hãy đi đến chứng chỉ API > Mã truy cập và nhấp vào Cài đặt ứng dụng để tạo ra các mã truy cập API.

• Mã truy cập Admin API

  • Cần xác thực để xem hoặc làm mới.

  • Có hiệu lực trong 3 năm kể từ khi được tạo ra.

  • Cho phép truy cập vào các điểm cuối API cấp quản trị.

• Mã truy cập Store API

  • Có thể sao chép trực tiếp mà không cần xác thực bổ sung.

  • Được sử dụng cho các tương tác API cấp cửa hàng.

Các mã này cho phép giao tiếp an toàn với các dịch vụ của SHOPLINE và phải được giữ bí mật. Nếu ứng dụng bị gỡ cài đặt hoặc cài đặt lại, các mã đã phát hành trước đó có thể trở nên không hợp lệ và phải được tạo lại.

Cài đặt ứng dụng

Trong tab Cài đặt ứng dụng, bạn có thể thay đổi tên ứng dụng, thông tin nhà phát triển và mô tả.

Bạn cũng có thể biến một ứng dụng riêng tư thành một Kênh Bán Hàng. Sau khi chuyển đổi, ứng dụng riêng tư có thể sử dụng các tính năng của kênh bán hàng, chẳng hạn như sử dụng Storefront API để lấy thông tin sản phẩm. Để biết thêm chi tiết, vui lòng tham khảo tài liệu dành cho nhà phát triển.

Xem nhật ký hoạt động

Chuyển sang Nhật ký hoạt động để xem tất cả các sự kiện hoạt động.

Gỡ cài đặt ứng dụng

Nhấp vào Gỡ cài đặt ứng dụng. Sau khi gỡ cài đặt, mã truy cập API sẽ bị thu hồi, và ứng dụng sẽ không còn quyền truy cập vào dữ liệu cửa hàng thông qua Open API.

Xóa ứng dụng phát triển

Quay lại trang chính Ứng dụng phát triển, nhấp vào Xóa để xóa ứng dụng đã chọn. Dữ liệu ứng dụng sẽ được xóa, và mã truy cập API sẽ bị thu hồi. Ứng dụng sẽ không còn quyền truy cập vào dữ liệu cửa hàng thông qua Open API.