Danh sách APIs
Sau khi đã lấy được access token thông qua quy trình xác thực OAuth2, bạn có thể sử dụng token này để truy cập vào các tài nguyên (resources) mà V-App OpenAPI cung cấp. Việc truy cập vào từng loại tài nguyên sẽ phụ thuộc vào các scope mà bạn đã được cấp quyền khi thực hiện quá trình ủy quyền. Mỗi scope đại diện cho một nhóm quyền truy cập nhất định, cho phép ứng dụng của bạn thực hiện các thao tác cụ thể trên từng loại tài nguyên.
Các tài nguyên của V-App OpenAPI được thiết kế để phục vụ nhiều nhu cầu khác nhau của ứng dụng, từ việc lấy thông tin người dùng, thực hiện giao dịch thanh toán, cho đến quản lý các dịch vụ mở rộng khác. Dưới đây là bảng tổng hợp các tài nguyên phổ biến mà bạn có thể truy cập, kèm theo scope yêu cầu, mô tả chi tiết về chức năng của từng tài nguyên, cũng như đường dẫn tới tài liệu hướng dẫn chi tiết:
| Tài nguyên | Scope khả dụng | Mô tả chi tiết | Tham khảo chi tiết |
|---|---|---|---|
| Định danh người dùng (user_id) | auth | Chỉ lấy được thông tin user_id của người dùng, không cần bật màn hình Consent. Thích hợp cho đăng nhập yên lặng (silent login) khi chỉ cần nhận diện người dùng đã từng dùng ứng dụng hay chưa. | Xem chi tiết |
| Hồ sơ người dùng | auth, profile, phone, email | Cho phép truy xuất thông tin cá nhân của người dùng như tên, email, số điện thoại, và các thuộc tính liên quan. Thường được sử dụng để hiển thị thông tin tài khoản, cá nhân hóa trải nghiệm hoặc xác thực người dùng trong ứng dụng. | Xem chi tiết |
| Thanh toán | Cung cấp các API để thực hiện, xác nhận và quản lý các giao dịch thanh toán. Bao gồm tạo đơn hàng, kiểm tra trạng thái giao dịch, xử lý thanh toán, và nhận thông báo về các sự kiện liên quan đến thanh toán. Phù hợp cho các ứng dụng thương mại điện tử, dịch vụ số hoặc các nền tảng cần tích hợp thanh toán. | Xem chi tiết |
Lưu ý: Danh sách tài nguyên và scope có thể được mở rộng hoặc thay đổi theo từng thời điểm. Để đảm bảo ứng dụng của bạn luôn cập nhật các quyền truy cập mới nhất, vui lòng thường xuyên tham khảo tài liệu chi tiết của từng API. Ngoài ra, hãy kiểm tra kỹ các scope mà bạn cần xin khi thực hiện ủy quyền để đảm bảo ứng dụng có đủ quyền truy cập vào các tài nguyên cần thiết. Nếu bạn cần truy cập các tài nguyên đặc biệt hoặc có nhu cầu tích hợp sâu hơn, hãy liên hệ với đội ngũ hỗ trợ của V-App để được tư vấn thêm.