聚合數據---(手機充值)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":"電信"
}

}