All Products
Search
Document Center

SuperApp:EMASMiniappUserAuthService (for WindVane)

Last Updated:Jun 08, 2026

User authorization interface for WindVane miniapps. Use this protocol to request auth codes and permission scopes from users.

The miniapp container provides this interface to request user authorization. This API applies only to WindVane miniapps.

@protocol EMASMiniappUserAuthService <NSObject>

getAuthCode

- (void)getAuthCode:(NSString *)appId scopes:(NSArray *)scopes  successBlock:(EMASMiniappUserAuthSuccessBlock)successBlock failureBlock:(EMASMiniappUserAuthFailureBlock)failureBlock;

Obtains an authorization code for accessing user information.

Parameters

appId

NSString: the miniapp ID requesting user authorization.

scopes

NSArray: the requested permission scopes.

successBlock

EMASMiniappUserAuthSuccessBlock: the callback invoked on success.

failureBlock

EMASMiniappUserAuthFailureBlock: the callback invoked on failure.

EMASMiniappUserAuthSuccessBlock

typedef void(^EMASMiniappUserAuthSuccessBlock)(NSString *authCode, NSArray * userAuthSuccessScopes, NSDictionary *userAuthErrorScopes);

Callback invoked when the requested permissions are granted.

Parameters

authCode

NSString: the authorization code.

authSuccessScopes

NSArray: the granted permission scopes.

userAuthErrorScopes

NSDictionary: the permission scopes that failed. Each key is a scope and the value is the error code.

EMASMiniappUserAuthFailureBlock

typedef void(^EMASMiniappUserAuthFailureBlock)(NSDictionary *userAuthErrorScopes);

Callback invoked when the requested permissions are denied.

Parameters

userAuthErrorScopes

NSDictionary: the permission scopes that failed. Each key is a scope and the value is the error code.