SDK for Objective-C

Github 地址：

https://github.com/Authing/authing-oc-sdkgithub.com

目前 iOS 的 SDK 只能从 OC 的源码集成，接口参考头文件，返回值说明参考：https://learn.authing.cn/authing/sdk/authing-sdk-for-web

接口头文件定义

#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN

typedef void (^success) (NSDictionary *value);
typedef void (^faile) (NSDictionary *value);

@interface AuthingManager : NSObject
+ (instancetype)shareAuthingSDK;
/**
 * 注册SDK
 * parameter的key
 * clientId
 * secret
 * user
 * oauth
 */
- (void)registerSDKWithClientId:(NSString *)clientId
                        success:(success)success
                          faile:(faile)faile;

/**
 * 登录
 * parameter的key说明
 * email
 * password
 * unionid，若不使用 email 和 password 则 unioinid 必选
 * verifyCode，可选，频繁注册时会要求输入验证码，返回数据会包含
 * lastIP，可选，若连续出现验证码验证失败情况，请将客户端 IP 填入
 * device，设备类型
 */
- (void)loginWithParameter:(NSDictionary *)parameter
                   success:(success)success
                     faile:(faile)faile;

/**
 * 注册
 * parameter的key说明
 * email
 * password
 * unionid，若不使用 email 和 password 则 unionid 必选
 * oauth 可选，oauth 信息的字符串，或者其他自定义的用户字段都可以以 JSON 字符串的形式存在这里
 * username，可选，用户名
 * nickname，可选，昵称
 * company，可选，公司名称
 * photo，可选，用户头像
 * lastIP，可选，用户登录的 IP 地址
 * device，设备类型
 */
- (void)registerWithParameter:(NSDictionary *)parameter
                      success:(success)success
                        faile:(faile)faile;

/**
 * 发送手机验证码
 * parameter的key说明
 * phone 手机号
 */
- (void)getVerificationCode:(NSDictionary *)parameter
                    success:(success)success
                      faile:(faile)faile;

/**
 * 使用手机验证码登录
 * parameter的key说明
 * phone，必填，手机号
 * phoneCode，必填，使用发送短信接口获取
 * device，设备类型
 */
- (void)loginByPhoneCode:(NSDictionary *)parameter
                 success:(success)success
                   faile:(faile)faile;

/**
 * 使用 LDAP 登录
 * parameter的key说明
 * username，在 LDAP 服务中的登录名，可以是邮箱或用户名
 * password，在 LDAP 服务中的密码
 * device，设备类型
 */
- (void)loginByLDAP:(NSDictionary *)parameter
            success:(success)success
              faile:(faile)faile;

/**
 * 刷新用户 Token
 * parameter的key说明
 * user 必填，用户的 _id
 */
- (void)reloadUser:(NSDictionary *)parameter
           success:(success)success
             faile:(faile)faile;

/**
 * 退出
 * parameter的key说明
 * user 必填，用户的 _id
 */
- (void)logout:(NSDictionary *)parameter
       success:(success)success
         faile:(faile)faile;

/**
 * 获取单个用户资料
 * parameter的key说明
 * user 必填，用户的 _id
 */
- (void)getUserMessage:(NSDictionary *)parameter
               success:(success)success
                 faile:(faile)faile;

/**
 * 一次性获取多个用户的资料
 * parameter的key说明
 * user 必填，用户的 _id
 */
- (void)getUserPatch:(NSDictionary *)parameter
             success:(success)success
               faile:(faile)faile;

/**
 * 获取用户列表
 * parameter的key说明
 * page Default: 1
 * count Default: 10
 */
- (void)getUserList:(NSDictionary *)parameter
            success:(success)success
              faile:(faile)faile;

/**
 * 删除用户
 * parameter的key说明
 * user 必填，用户的 _id
 */
- (void)deleteUser:(NSDictionary *)parameter
           success:(success)success
             faile:(faile)faile;

/**
 * 获取用户权限和角色
 * parameter的key说明
 * userId
 */
- (void)queryPermissions:(NSString *)userId
                 success:(success)success
                   faile:(faile)faile;

/**
 * 获取应用下所有角色
 * parameter的key说明
 * page: 第几页，选填，默认为 1
 * count: 总数，选填，默认为 10
 */
- (void)queryRoles:(NSDictionary *)parameter
           success:(success)success
             faile:(faile)faile;

/**
 * 创建用户角色
 * parameter的key说明
 * name: 角色名称，必填
 * descriptions: 角色描述，必填
 */
- (void)createRole:(NSDictionary *)parameter
           success:(success)success
             faile:(faile)faile;

/**
 * 修改角色权限
 * parameter的key说明
 * name: 角色名称，必填
 * roleId: 角色 ID，必填
 * permissions: 角色权限，必填。输入自定义的权限字符串，可以是 JSON 或数组；之后可以通过 API 获取此处设置的权限既而实现自己的业务逻辑。
 */
- (void)updateRolePermissions:(NSDictionary *)parameter
                      success:(success)success
                        faile:(faile)faile;
/**
 * 指派用户到某角色
 * userId
 */
- (void)assignUserToRole:(NSString *)userId
                 success:(success)success
                   faile:(faile)faile;

/**
 * 将用户从某角色中移除
 * parameter的key说明
 * roleId: 角色 ID，必填
 * user: 要指派的用户 ID，必填
 */
- (void)removeUserFromRole:(NSDictionary *)parameter
                   success:(success)success
                     faile:(faile)faile;

/**
 * 将用户从某角色中移除
 * parameter的key说明
 * _id {String} 必填
 * email {String}，选填
 * emailVerified: {Boolean}，选填，邮箱是否经过验证
 * username: {String}，选填
 * nickname: {String}，选填
 * company: {String}，选填
 * phone: {String}，选填
 * oauth: {String}，选填，oauth 信息
 * browser: {String}，选填，用户注册时所用的浏览器
 * password: {String}，选填，用户密码
 * oldPassword: {String}（当有 password 时，旧密码参数必需填写）
 * token: {String}，选填
 * tokenExpiredAt: {String}，选填，token 过期时间
 * loginsCount: {Number}，选填，登录次数
 * lastLogin: {String}，选填，最后登录时间
 * lastIP: {String}，选填，最后登录 IP
 * signedUp: {String}，选填，注册时间
 * blocked: {Boolean}，选填，是否被锁定
 * isDeleted: {Boolean}，选填，是否被删除
 */
- (void)updateUserMessage:(NSDictionary *)parameter
                  success:(success)success
                    faile:(faile)faile;
@end

NS_ASSUME_NONNULL_END