Tencent Cloud Super App as a Service
- Release Notes and Announcements
- Purchasing Guide
- Plan Management
- Branded Configurations
- Introduction to Platform Functions
- Commercialization
- Guidelines for Code Integration
- Android
- Android SDK Description
- Android API
- Mini Program Management APIs
- Custom Mini Program Capabilities
- Custom SDK Capabilities
- iOS
- iOS SDK Description
- iOS API
- Mini Program Management APIs
- Customize Mini Program Capabilities
- Customised SDK Capabilities
- Flutter
- Flutter SDK Description
- Flutter API
- Mini Program Management API
- Mini Program Capabilities Customization
- Plugin Customization
- App Server
- Guildlines for Mini Program Development
- Mini Program Code Composition
- Guidance
- Learn About Mini Programs
- Configuring Mini Program
- Mini Program Framework
- Framework
- Mini Program Configuration
- Framework Interface
- WXML Syntax Reference
- WXS Syntax Reference
- Components
- API
- Interface
- Media
- Device
- JS SDK
- IDE Operation Instructions
- Guildlines for Mini Game Development
- Guide
- Game Engine
- API
- Rendering
- Device
- Practice Tutorial
- API Documentation
- Making API Requests
- User Management APIs
- Team Management APIs
- Sensitive API-Related APIs
- Role Management APIs
- Platform Management APIs
- Other Console APIs
- Mini Program APIs
- Management-Sensitive APIs
- Global Domain Management APIs
- Application APIs
DocumentationTencent Cloud Super App as a ServiceGuildlines for Mini Game DevelopmentGuideBasic CapabilityAuthorize
Authorize
Last updated: 2025-02-24 17:10:38
Some APIs require user consent before they can be called. These APIs are divided into multiple
scopes based on their usage. When a user grants authorization to a scope , all APIs corresponding to that scope can be used directly.When calling such APIs:
If the user has neither accepted nor rejected the permission, a popup will ask for the user's consent. The API can be called only after the user agrees.
If the user has already granted permission, the APIs can be called directly.
If the user has rejected authorization, no popup will appear, and the API will directly enter the
fail callback. Developers should ensure their applications handle scenarios where the user has denied permission.Obtain user authorization status
Open the settings page
Users can control the authorization status of the mini program in the settings page (accessible via the "..." menu in the top right corner).
Developers can call wx.openSetting to open the settings page and guide the user to enable authorization.
Initiate an authorization request in advance
Developers can use wx.authorize to initiate an authorization request to the user in advance before calling the authorization API.
Scope list
Scope | API | Description |
scope.userInfo | User information. | |
scope.userLocation | Precise location. | |
scope.userFuzzyLocation | Fuzzy location. | |
scope.writePhotosAlbum | Saves to album. |
Authorization validity
Once a user explicitly agrees to or rejects an authorization, the authorization status is recorded in the local cache until the user actively deletes the mini game.
Usage suggestions
Request authorization from the user only when you actually need to use the authorized API. Clearly explain the reason for needing the functionality in the authorization request.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No