聚合数据iOS SDK 全国车辆违章 演示示例

1，将聚合数据SDK（JuheApis.framework）添加到你的程序中来，SDK依赖的包包括：

2，在聚合SDK Framework的JHSDKAPIPath.h文件中找到快递查询接口宏，以及字典参数

/**
  @brief 车辆违章查询--1、获取支持城市接口

@param	province	string	非必填	默认全部，省份简写，如：ZJ、JS
@param	dtype	string	非必填	返回数据格式：json或xml或jsonp,默认json
@param	callback	string	非必填	当选择jsonp格式时必须传递

*/
#define kJHAPIS_LIFE_WZ_CITYS               @"juhe.apis.wz.citys"               //1、获取支持城市接口

/**
 @brief 车辆违章查询--2、请求违章查询接口

@param	dtype	string	必填	返回数据格式：json或xml或jsonp,默认json
@param	callback	string	非必填	当选择jsonp格式时必须传递
@param	ity	string	必填	城市代码 *
@param	hphm	string	必填	号牌号码 完整7位
@param	hpzl	string	必填	号牌类型，默认02
@param	engineno	string	非必填	发动机号 (根据城市接口中的参数填写)
@param	classno	string	非必填	车架号 (根据城市接口中的参数填写)

*/
#define kJHAPIS_LIFE_WZ_QUERY               @"juhe.apis.wz.query"               //2、请求违章查询接口

/**
 @brief 车辆违章查询--3、车辆（号牌）种类编号查询接口

@param	dtype	String	非必填	返回数据格式：json或xml或jsonp,默认json
@param	callback	String	非必填	返回格式选择jsonp时，必须传递

*/
#define kJHAPIS_LIFE_WZ_HPZL                @"juhe.apis.wz.hpzl"                //3、车辆（号牌）种类编号查询接口

/**
 @brief 车辆违章查询--4、接口剩余次数查询

@param

dtype

string

非必填

返回数据的格式,xml或json，默认json

*/
#define kJHAPIS_LIFE_WZ_STATUS              @"juhe.apis.wz.status"              //4、接口剩余次数查询

3，接口在程序中调用方法（将ViewController.m改为.mm）

#import "ViewController.h"

#import <JuheApis/JuheAPI.h>
#import <JuheApis/JHOpenidSupplier.h>
#import <JuheApis/JHSDKAPIPath.h>

@interface ViewController ()
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view, typically from a nib.
    [[JHOpenidSupplier shareSupplier] registerJuheAPIByOpenId:@"申请到的OpenId“];
    
    UIButton* beginBtn=[UIButton buttonWithType:UIButtonTypeSystem];
    beginBtn.frame=CGRectMake(20, 111, 280, 40);
    [beginBtn setTitle:@"开始" forState:UIControlStateNormal];
    [beginBtn setTitleColor:[UIColor darkGrayColor] forState:UIControlStateNormal];
    [beginBtn addTarget:self action:@selector(doTestAction) forControlEvents:UIControlEventTouchUpInside];
    [beginBtn setBackgroundImage:[UIImage imageNamed:@"button5"] forState:UIControlStateNormal];
    [self.view addSubview:beginBtn];
}

- (void)doTestAction
{
    /* 1、获取支持城市接口 */
    [self test :  kJHAPIS_LIFE_WZ_CITYS         parameters : @{@"province":@"JS",@"dtype":@"json"} ] ;
    /* 2、请求违章查询接口 */
    [self test :  kJHAPIS_LIFE_WZ_QUERY       parameters : @{@"dtype":@"json",@"city":@"SH",@"hphm”:@“苏L50A11",@"hpzl":@"02"}] ;
    /* 3、车辆（号牌）种类编号查询接口 */
    [self test :  kJHAPIS_LIFE_WZ_HPZL          parameters : @{@"dtype":@"json" }];
    /* 4、接口剩余次数查询 */
    [self test :  kJHAPIS_LIFE_WZ_STATUS      parameters : @{@"dtype":@"json" }];
   
}

- (void)test:(NSString *)path  parameters:(NSDictionary *)parameters{
    
    JuheAPI *juheapi = [JuheAPI shareJuheApi];
    [juheapi executeWorkWithAPI:path
                     parameters:parameters
                        success:^(id responseObject){
                            if ([[parameters 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);
                        }];
}

- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
    // Dispose of any resources that can be recreated.
}

@end

4,全国车辆违章接口返回数据说明以及错误码说明

1 . API :  kJHAPIS_LIFE_WZ_CITYS

名称				类型	说明
resultcode				int	返回码
reason				string	返回说明
result				dictionary	返回结果
	key			String	省份代码()
		province		String	省份名称
		citys		Array	省份下开通城市数组
			city_code	String	城市代码
			city_name	String	城市名称
			engine	Int	是否需要发动机号0,不需要 1,需要
			engineno	Int	需要几位发动机号0,全部 1-9 ,需要发动机号后N位
			class	Int	是否需要车架号0,不需要 1,需要
			classa	Int	同上,（解决java中class关键字无法映射）
			classno	Int	需要几位车架号0,全部 1-9需要车架号后N位
			regist	Int	是否需要登记证书号0,不需要 1,需要
			registno	Int	需要几位登记证书0,全部 1-9需要登记证书后N位
error_code				Int	错误码

2 . API ：kJHAPIS_LIFE_WZ_QUERY

名称			类型	说明
resultcode			int	返回码
reason			string	返回说明
result			dictionary	返回结果
	province		string	查询省份代码
	city		string	查询城市代码
	hphm		string	查询的号牌号码
	lists		Array	违章列表
		date	string	违章时间
		area	string	违章地点
		act	string	违章行为
		code	string	违章代码(仅供参考)
		fen	string	违章扣分(仅供参考)
		money	string	违章罚款(仅供参考)
		handled	string	是否处理,1处理 0未处理空未知
error_code			int	错误码

3 . API ：kJHAPIS_LIFE_WZ_HPZL

名称		类型	说明
resultcode		int	返回码
reason		string	返回说明
result		dictionary	返回结果
	car	string	车辆类型
	id	int	车辆类型编号
error_code		int	错误码

4 . API ：kJHAPIS_LIFE_WZ_STATUS

名称		类型	说明
resultcode		int	返回码
reason		string	返回说明
result		dictionary	返回结果
	surplus	string	剩余次数
error_code		int	错误码

   错误码  

	错误码	说明
	203603	网络错误请重试
	203604	传递参数的格式不正确
	203605	没找到此城市代码或该城市正在维护
	203606	车辆信息错误,请确认输入的信息正确
	203607	交管局网络原因暂时无法查询
	203608	您好,你所查询的城市正在维护或未开通查询

5, 更多聚合数据SDK接口，访问这里： http://www.juhe.cn/juhesdk/idocs