KSVPNUFacade(Networking)
Use the links in the table of contents to the left to access the documentation.
Extends: ass: KSVPNUFacade
Declared in: KSVPNUFacade.h
Instance Methods
accountStatusWithCompletion:
- (void)accountStatusWithCompletion:(void(^)(NSError *error, VPNUAccountStatus *accountStatus))completion;
Retrieves the currently logged-in user's account status.
Parameters
- completion
- Block to be called upon operation completion.
See also
authorizeWithLogin:andPassword:completion:
- (void)authorizeWithLogin:(NSString *)login andPassword:(NSString *)password completion:(void(^)(NSError *error))completion;
Performs authorization.
Parameters
- login
- User's login. Cannot be nil.
- password
- User's password. Cannot be nil.
- completion
- Block to be called upon operation completion.
Discussion
This method tries to authorize a user with specified login and password. If authorization is successful it automatically sets the currentUserInfo property.
changeAccountPasswordWithLogin:oldPassword:newPassword:completion:
- (void)changeAccountPasswordWithLogin:(NSString *)login oldPassword:(NSString *)oldPassword newPassword:(NSString *)newPassword completion:(void(^)(NSError *error))completion;
Changes password for a user identifiied by login parameter.
Parameters
- login
- User's login/email.
- oldPassword
- User's current password.
- newPassword
- User's new password.
- completion
- Block to be called upon operation completion. Possible error responses: 302, 323, 500, 502, 503
Discussion
If password was changed successfully it automatically reauthorizes user with new password. This method doesn't perform any local checks on provided passwords. If you need these checks you have to implement them.
enterCode:completion:
- (void)enterCode:(NSString *)code completion:(void(^)(NSError *error))completion;
Sends redeem code to server.
Parameters
- code
- Reddem code string.
- completion
- Block to be called upon operation completion. Possible error responses: 351, 352, 502, 503
Discussion
This method does not perform code validation locally. If you want code validation feature you have to implement it.
See also
freeOptimalServersListWithCompletion:
- (void)freeOptimalServersListWithCompletion:(void(^)(NSError *error, NSArray<VPNUServerItem *> *serversList))completion DEPRECATED_MSG_ATTRIBUTE("Use -serverListWithOptions:completion: instead");
Retrieves a list of optimal VPN servers with no need to logged-in.
Parameters
- completion
- Block to be called upon operation completion.
See also
freeServersListWithCompletion:
- (void)freeServersListWithCompletion:(void(^)(NSError *error, NSArray<VPNUServerItem *> *serversList))completion DEPRECATED_MSG_ATTRIBUTE("Use -serverListWithOptions:completion: instead");
Retrieves a list of available VPN servers with no need to logged-in.
Parameters
- completion
- Block to be called upon operation completion.
See also
geolocateMeWithSquareFlags:completion:
- (void)geolocateMeWithSquareFlags:(BOOL)squareFlags completion:(void(^)(NSError *error, NSDictionary *result))completion;
Retrieves a user current location with no need to logged-in.
Parameters
- squareFlags
- YES - square; NO - round
- completion
- Block to be called upon operation completion.
optimalServersListWithCompletion:
- (void)optimalServersListWithCompletion:(void(^)(NSError *error, NSArray<VPNUServerItem *> *serversList))completion DEPRECATED_MSG_ATTRIBUTE("Use -serverListWithOptions:completion: instead");
Retrieves a list of optimal VPN servers for currently logged-in user.
Parameters
- completion
- Block to be called upon operation completion.
personalIPServersList:
- (void)personalIPServersList:(void(^)(NSError *error, NSDictionary *result))completion;
Returns the list of available personal IPs.
Parameters
- completion
- Block to be called upon operation completion.
personalServerRegionsList:
- (void)personalServerRegionsList:(void(^)(NSError *error, NSDictionary *result))completion;
Returns the list of available personal servers.
Parameters
- completion
- Block to be called upon operation completion.
recoveryPasswordForLogin:completion:
- (void)recoveryPasswordForLogin:(NSString *)login completion:(void(^)(NSError *error))completion;
Sends recovery password instructions.
Parameters
- login
- User's login/email.
- completion
- Block to be called upon operation completion. Possible error responses: 361, 502, 504
Discussion
Instructions are sent to the email of user specified in login parameter.
See also
registerWithLogin:andPassword:marketingEmails:completion:
- (void)registerWithLogin:(NSString *)login andPassword:(NSString *)password marketingEmails:(BOOL)doNotRecieveMarketingEmails completion:(void(^)(NSError *error))completion;
Registers a new user.
Parameters
- login
- User's login. Cannot be nil.
- password
- User's password. Cannot be nil.
- doNotRecieveMarketingEmails
- Marketing e-mails for the user. YES for not to receive marketing letters for this account, NO for recieve.
- completion
- Block to be called upon operation completion.
Discussion
This method tries to register a new user with specified login and password synchronously and waits for the response. If registration is successful, it automatically logs in the newly created user.
sendConfirmationEmailWithLogin:completion:
- (void)sendConfirmationEmailWithLogin:(NSString *)login completion:(void(^)(NSError *error))completion;
Sends account confirmation email.
Parameters
- login
- User's login.
- completion
- Block to be called upon operation completion. Possible error responses: 361, 502, 504
Discussion
This method sends an account confirmation letter to user's email.
See also
serverListWithOptions:completion:
- (void)serverListWithOptions:(KSVPNUServerListOptions)mask completion:(void(^)(NSError *error, NSArray<VPNUServerItem *> *serversList))completion;
Retrieves a list of available VPN servers for provided options.
Parameters
- mask
- Bitmask of KSVPNUServerListOptions values. Default is 0.
- completion
- Block to be called upon operation completion.
See also
serversListWithCompletion:
- (void)serversListWithCompletion:(void(^)(NSError *error, NSArray<VPNUServerItem *> *serversList))completion DEPRECATED_MSG_ATTRIBUTE("Use -serverListWithOptions:completion: instead");
Retrieves a list of available VPN servers for currently logged-in user.
Parameters
- completion
- Block to be called upon operation completion.
See also
signOutWithCompletion:
- (void)signOutWithCompletion:(void(^)(BOOL successful, NSError *error))completion;
Signs out the already authorized user.
Parameters
- completion
- Block to be called upon operation completion.
Discussion
This method clears current session and signals server about sign-out event.
userDeviceInfoWithCompletion:
- (void)userDeviceInfoWithCompletion:(void(^)(NSError *error, VPNUAccountDevice *deviceInfo))completion;
Retrieves the currently logged-in user's device information.
Parameters
- completion
- Block to be called upon operation completion.
See also
userInfoWithCompletion:
- (void)userInfoWithCompletion:(void(^)(NSError *error, VPNUAccountUserInfo *userInfo))completion;
Retrieves the currently logged-in user's account information.
Parameters
- completion
- Block to be called upon operation completion. Possible error responses: 502, 503
See also
validatePurchaseItem:completion:
- (void)validatePurchaseItem:(VPNUPurchaseItem *)purchaseItem completion:(void(^)(NSError *error))completion;
Validates a provided purchase item on server.
Parameters
- purchaseItem
- A purchase item for which to perform the validation.
- completion
- Block to be called upon operation completion.
See also