生成App接口_封装App接口-变色龙开放平台

生成App接口介绍

实现网站封装成App或混合开发App。集成到自已网站系统内，用户自主管理应用。

接口

URL地址：https://api.appbsl.net/api/cpl/make

请求方式：POST

请求参数说明

参数名	必选	类型	说明	示例
user_key	是	string	开放平台-个人中心-接口配置-KEY的md5值	89unzUJ8i
user_secret	是	string	开放平台-个人中心-接口配置-SECRET的md5值	8skjsllsd
api_name	是	string	App版本代号，详细说明	version0
systype	是	int	要编译的系统类型,1安卓，2苹果。	1
data_path	是	string	配置文件的下载链接,详细说明	http://xxxx.com/v1.json
identifier	是	string	网站使用的唯一标志，建议用用户ID值，用于错误定位和数据返回	1
package_name	是	string	苹果的BundleID或安卓的包名	com.appbsl.www
ios_cer	是	string	苹果的证书下载地址（含http的完整地址），编译苹果必传项	http://xxxx.com/v1.p12
ios_configuration	是	string	对应苹果证书的描述文件，编译苹果必传项	http://xxxx.com/v1.mobileconfig
ios_cer_pwd	是	string	苹果证书的密码，编译苹果必传项	dd123
ios_cer_pwd	是	string	苹果证书的密码，编译苹果必传项	dd123
and_cer	是	string	安卓keystore文件的完整下载地址,编译安卓必传项	http://xxxx.com/v1.key
and_cer_alias	是	string	安卓keystore文件的别名,编译安卓必传项	dd123
and_cer_pwd	是	string	安卓keystore文件的密码,编译安卓必传项	dd123
and_cer_store_pwd	是	string	安卓keystore文件的store密码,编译安卓必传项	dd123
local_resources_zip	否	string	本地资源的zip资源包路径（含http的完整地址）详细说明	ttp://xxxx.com/v1.zip
site_domain	是	string	您网站的主域名，带http或https前缀	https://www.bslyun.com
shop_title	是	string	您网站的名称	变色龙云
host_url	是	string	pp打包使用的首页地址（含http&https的完整地址）	https://www.bslyun.com
version_count	是	int	生成的版本计数，用于升级接口的版本比对。	2
version	是	string	app打包使用的版本号	1.0.0
updateurl	是	string	升级地址，详见下方说明详细说明	https://www.bslyun.com/up1293838
adurl	是	string	广告地址，详见下方说明详细说明	https://www.bslyun.com/ad1293838
callback	是	string	编译回调地址，详见下方说明详细说明	https://www.bslyun.com/mkapp123
logo	是	string	app打包使用的logo图片列表，详见下方说明详细说明	eyJodHRwOlwvX...bmcifQ==
startpage	是	string	app打包使用的启动页图片列表，详见下方说明详细说明	eyJodHRwOlwvX...bmcifQ==
inid	是	string	开放平台在创建应用时返回的唯一识别号，详情见应用创建接口	com.kjcuxe.kydeoic
ios_sub_type	是	int	苹果的详细系统类型，1iphone，3iphone+ipad	1

注：数值项必须全部提供，编译前请先创建应用。安卓与苹果是独立分开生成的，生成单独系统发起一次编译创建应用帮助

App版本代号

名称	代号	说明
高级版	v2test
中级版	version150
初级版	version50
基础版	ten
免费版	version0

json配置文件项

包含所有配置内容的json文件，免费版包含240+配置项，高级版包含360+配置项。配置项不配置必须有变量，值可以为空。各版本JSON配置详细

本地资源

压缩包类型：zip
本地资源包的目的是为了将部分网站资源打包进app中，以提高加载速度，减少网络请求。可以只更换JS，css，常用图片，也可以整体离线html+CSS+JS+图片。离线文件帮助

升级地址

生成的app，在打开时会首先访问提供的升级接口
发送方式：POST

参数	必选	说明
appid	string	生成App的inid值
mainurl	string	app包内的主页地址
version	int	版本号数字，对应参数中的version_count

返回数据

"code":"200",//200成功，其他失败
"datas":{
	"force":"1",    //是否强制弹出的提示框只显示确定，1仅显示确定，0显示确定取消
	"close":"1",    //点击弹出框的确定键是否强制退出app，1强制退出，0不强制退出
	"v_code":"",    //系统内当前最新的版本号，对应version
	"name":"",    //应用的名称
	"v_no":"",    //系统内当前最新的版本计数，对应version_count
	"path":"",    //如果需要升级，本字段返回升级需要的apk包地址或苹果的plist文件地址
},
"msg":""         //说明内容

广告接口

生成的app，在打开时会在升级接口之后访问广告接口
发送方式：POST

参数	必选	说明
appid	string	生成App的inid值

返回数据

"code":"200",//200成功，其他失败
"datas":{
	"ad_url":"",    //点击广告图片需要跳转到的链接
	"ad_pic":"",    //广告图片的完整地址
	"ad_delay_time":"",    //广告的持续时间，单位秒
	"ad_name":"",    //广告的名称
},
"msg":""         //说明内容

编译回调地址

编译的过程中会在各个阶段将当前的进展数据发送至回调地址，
链接需包含您本应用的标识，以免无法识别
发送方式：POST

参数	必选	说明
code	string	安卓:150编译中，152错误，153成功 iOS:250编译中,252错误,253成功

返回数据

res:{
	"code":"150",        //安卓150编译中，152错误，153成功//iOS250编译中,252错误,253成功
	"data":{
		"ios_sub_type":"1",        //苹果的子系统号，1iphone，3iphone+ipad
		"systype":"3",        //系统，1安卓，2iOS
		"msg":"",        //结果的消息内容
		"url":"http://***/***.apk"        //如编译成功，返回apk或ipa包的下载地址
	},
	"error_code":"0011-0013"        //详细错误代码
}

logo内容

UrlEncode编码base64的logo图片数组的内容
结构：

{
	["pic_source1"] => "pic_target1"
	["图片的获取路径"] => "要放在项目中的相对路径"
}

图片要求：
以下为所有图片要求大小，请更换到自已图片。 android：

{
	["您的原图地址"] => "/app/src/main/res/mipmap-xxhdpi/ic_launcher.png"//尺寸 144*144 px
}

iOS：

{
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/40.png",//尺寸 40*40 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/58.png",//尺寸 58*58 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/60.png",//尺寸 60*60 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/80.png",//尺寸 80*80 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/87.png",//尺寸 87*87 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/120-1.png",//尺寸 120*120 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/180.png",//尺寸 180*180 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/Icon-20.png",//尺寸 20*20 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/Icon-29.png",//尺寸 29*29 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/Icon-76.png",//尺寸 76*76 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/Icon-152.png",//尺寸 152*152 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/Icon-167.png",//尺寸 167*167 px
}

例：
android结构

{
	["http://www.appbsl.net/in.png"] => "/app/src/main/res/mipmap-xxhdpi/ic_launcher.png"//尺寸 144*144 px
}

startpage内容

UrlEncode编码base64的startpage图片数组的内容
结构：

{
	["pic_source1"] => "pic_target1"
	["图片的获取路径"] => "要放在项目中的相对路径"
}

图片要求：
android：

{
	["您的原图地址"] => "/app/src/main/res/mipmap-xxhdpi/guide.png",//尺寸 1080*1920 px
	["您的原图地址"] => "/app/src/main/res/mipmap-h642dp-port-xxhdpi/guide.png"//尺寸 1080*2160 px
}

iOS：
iphone:

{
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/640-960.png",//尺寸 640*960 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/640-1136.png",//尺寸 640*1136 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/750-1334.png",//尺寸 750*1334 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/1242-2208.png",//尺寸 1242*2208 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/1125-2436.png",//尺寸 1125*2436 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/828-1792.png",//尺寸 828*1792 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/1242-2688.png",//尺寸 1242*2688 px
}

ipad:

{
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/768_1024.png",//尺寸 768*1024 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/1536_2048.png",//尺寸 1536*2048 px
}

例：
android数据

{
	["http://www.appbsl.net/in.png"] => "/app/src/main/res/mipmap-xxhdpi/guide.png",//尺寸 1080*1920 px
	["http://www.appbsl.net/in2.png"] => "/app/src/main/res/mipmap-h642dp-port-xxhdpi/guide.png"//尺寸 1080*2160 px
}

如需同时编译iphone，ipad请将以上两个数组合成一个即可。

API开发文档