简体中文
简体中文
English
联系我们
注册
登录

通用接口

更新时间:2022-02-17 05:33:48下载pdf

通用接口是调用服务端 API,调用功能对应 TuyaSmartRequest 类。

单独调用

一个业务接口单独发起请求时,两个方法需要一起使用。

接口说明

- (void)requestWithApiName:(NSString *)apiName
				  postData:(nullable NSDictionary *)postData
				   getData:(nullable NSDictionary *)getData
				   version:(NSString *)version
				   success:(nullable TYSuccessID)success
				   failure:(nullable TYFailureError)failure;

参数说明

参数 说明
apiName API 名称
postData 业务参数
getData 公共参数
version API 版本号
success 成功回调
failure 失败回调

Objective-C 示例

- (void)getCountryList {
  // self.request = [TuyaSmartRequest alloc] init];

  [self.request requestWithApiName:@"tuya.m.country.list" postData:nil version:@"1.0" success:^(id result) {

  } failure:^(NSError *error) {

  }];

}

组合接口

多个业务接口一起发起请求时,两个方法需要一起使用。

接口说明

- (void)addMergeRequestWithApiName:(NSString *)apiName
						  postData:(nullable NSDictionary *)postData
						   version:(NSString *)version
						   success:(nullable TYSuccessID)success
						   failure:(nullable TYFailureError)failure;

- (void)sendMergeRequestWithGetData:(nullable NSDictionary *)getData
							success:(nullable TYSuccessList)success
							failure:(nullable TYFailureError)failure;

参数说明

参数 说明
apiName API名称
postData 业务参数
version API版本号
getData 公共参数
success 成功回调
failure 失败回调

Objective-C 示例

- (void)loadHomeDataWithHomeId:(long long)homeId {
  // self.request = [TuyaSmartRequest alloc] init];

  [self.request addMergeRequestWithApiName:@"tuya.m.my.group.mesh.list" postData:@{} version:@"1.0" success:nil failure:nil];
  [self.request addApiRequest:@"tuya.m.location.get" postData:@{@"gid": @(homeId)} version:@"2.0" success:nil failure:nil];

  [self.request sendMergeRequestWithGetData:@{@"gid": @(homeId)} success:success failure:failure];
}