聚合数据---(手机充值)iOS SDK V2.0 简易开发指南

https://www.juhe.cn/juhesdk/idocs/v/2

iOS SDK V2.0 简易开发指南

该文档仅适用于iOS版本聚合数据SDK V2.0+，此版本调整了SDK整体结构与V1.0有较大差异，增加调用的灵活性，与便捷。改变聚合数据SDK的接入方式，下面是简易的开发流程说明。详细问题您可以通过 相关下载 下载相应的文档、示例包、SDK。

一、SDK导入

将JuheApisSDK.a以及头文件“include”文件夹添加到自己的工程中来，添加依赖库CoreTelephony.framework， AdSupport.framework, CoreLocation.framework。
注：1、开发环境使用xCode6.0以上版本进行开发。
       2、将AppDelegate.m改为AppDelegate.mm，或者选中项目，在右侧的设置窗口中选择：TARGETS->XXX(项目名)->Build Phases->Link Binary With Libraries，添加libc++.dylib。

二、初始化SDK

在调用接口之前需要初始化聚合数据SDK，并绑定用户唯一的openid。在调用具体的接口之前只需要绑定一次即可。
引入聚合数据SDK的头文件：JHAPISDK.h, JHOpenidSupplier.h

#import <JHAPISDK.h> 
#import <JHOpenidSupplier.h> 
- (void)viewDidLoad {
[super viewDidLoad];
[[JHOpenidSupplier shareSupplier] registerJuheAPIByOpenId:@"用户的openid"];

}

三、查找调用接口的参数值

在聚合数据API官网上http://www.juhe.cn/docs查看接口，并得到调用接口必须的字段：API， APIID， Method，以及需要设置的参数调用对应接口。
例：生活常用 -> IP地址 -> 根据IP/域名查询地址 (前提：已经在聚合平台申请了该数据服务)

api,api_id,method的获取如下图所示：

Param的获取方法：

四、编写代码调用具体的数据接口

//    /*IP*/ 
NSString *path = @"http://apis.juhe.cn/ip/ip2addr";
NSString *api_id = @"1";
NSString *method = @"GET";
NSDictionary *param = @{@"ip":@"www.juhe.cn", @"dtype":@"json"};
JHAPISDK *juheapi = [JHAPISDK shareJHAPISDK];

[juheapi executeWorkWithAPI:path
APIID:api_id
Parameters:param
Method:method
Success:^(id responseObject){
if ([[param objectForKey:@"dtype"] isEqualToString:@"xml"]) {
    NSLog(@"***xml*** \n %@", responseObject);
}else{
int error_code = [[responseObject objectForKey:@"error_code"] intValue];
if (!error_code) {
    NSLog(@" %@", responseObject);
}else{
    NSLog(@" %@", responseObject);
}
}
} Failure:^(NSError *error) {
    NSLog(@"error:   %@",error.description);
}];

*详细文档及其他数据说明请通过 http://www.juhe.cn/docs 查阅。

五、返回数据示例

{
"resultcode":"200",
"reason":"Return Successd!",
"result":{
"area":"江苏省苏州市",
"location":"电信"
}

}