内测侠开放自动化签名分发的网站接口

admin

通过自动化接口,可以实现第三方平台调用内测侠接口,提交udid,ipa编号后, 内测侠自动签名.成功签名并生成安装地址后,内测侠会将安装地址数据发送到配置的回传地址!


1.内测侠接收udid自动化签名任务接口
   地址: https://www.neicexia.com/public_service/create_automation_service
  Post参数:
  

参数名称	类型	长度限制	说明	示例
udid	string		设备UDID数据,多条数据需要以换行或者“;"分隔,当gain_cer_type为1时必填	c1de9900811ae4497721ab0bd86b8961959f7d12;c1de9900811ae4497721ab0bd86b8961959f7d3f
udid_region_pool	string		udid区域池,公共池:public,独立池:private,默认值:auto(当独立池可以添加udid时，优先使用独立池)	auto
udid_batch	string		udid批次号,当gain_cer_type为2时必填	EASC3
gain_cer_type	int		获取证书方式:1.udid新签(默认使用此值);2.通过udid批次号重签	1
use_new_account_when_apple_processing	int		当使用独立池添加的udid设备状态为苹果处理中时:1.切换新的可用账号续继添加;0:默认报错处理	1
force_use_appleid	string		当使用独立池时，可以指定强制添加udid到这个appleid.	your_appleid@icloud.com
ipa_source_type	int		IPA来源: 1.服务器IPA;2.远程网址.
ipa_url	string	200	ipa来源为2时可用; ipa的远程下载网址	http://www.yoursite.com/test.ipa
ipa_new_appid	string		ipa来源为2时可用; 新的appid;	com.company.testapp1
ipa_new_name	string		ipa来源为2时可用; 新的app名称;	测试app
ipa_no	string		ipa来源为1时可用; ipa编号，可以在内测侠网站的ipa管理中查看,如果同时签名多个ipa，则用";"分隔	EFTU6;EFTU7
task_id	string	100	用户自定义的数据，签名完成时会回传此数据	1234
info_plist_set	string	200	设置Info.plist的键值对,键值之间用":"分隔,多个键值对用";"分隔	key1:value1;key2:value2
token	string		接口token,此数据可以内测侠网站“配置自动化接口”界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded
返回数据(json)格式:

{
    "IsSuccess": true,
    "ErrorMessage": null,
    "Data": {
        "udid_batch_no": "RS3ZH", //udid批次号
        "cer_batch_no": "RS3ZK", //证书账号批次号,使用udid批次号重签时不返回此项        
        "task_batch_no": "CAS3A", //签名任务批次号（2018/1/18新增)
        "cer_appleid": "test_mail@sina.com", //仅使用独立池账号时返回，使用udid批次号重签时不返回此项
        "team_identifier": "73BSYFTSAF" 
    },
    "ErrorCode": 0
}

调用接口前，请确保udid及在线签名余额充足。


2.内测侠签名完成之后回传数据到用户网站
  地址： 用户在内测侠网站配置的回传地址
  Post参数:

参数名称	类型	长度限制	说明	示例
task_id	string	100	用户在前面接口传入的数据	1234
install_url	string		签名完成之后生成的内测侠安装地址,如果有多个ipa，则地址之间用;隔开	https://www.neicexia.com/v/ABNAD;https://www.neicexia.com/v/ABNAE
plist_url	string		签名完成之后生成的内测侠plist文件地址,如果有多个ipa，则地址之间用;隔开	https://www.neicexia.com/PlistFile/Get/ABNAD;https://www.neicexia.com/PlistFile/Get/ABNAE
file_name	string		签名完成之后生成的云存储文件名,如果有多个ipa，则文件名之间用;隔开	uploaddata/test1.ipa;uploaddata/test2.ipa

内测侠会检查回传请求响应的结果，如果状态码为200则表示回传并处理成功。
如果不是200的状态码，内测侠会连续重试三次。

3.查询udid对应的udid批次号    地址: https://www.neicexia.com/public_service/query_cer
  Post参数:

参数名称	类型	长度限制	说明	示例
udid	string		设备UDID数据	c1de9900811ae4497721ab0bd86b8961959f7d12
skip_processing_udid	string		"1"表示跳过审核中的udid,"0"表示不跳过审核中的udid,默认值为"0"	"0"
token	string		接口token,此数据可以内测侠网站“配置自动化接口”界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded


返回结果:

{
    "IsSuccess": true,
    "Data": {
        "udid_batch_no": "HWS53",
        "create_date": "2021-09-28",
        "expire_date": "2021-09-27T18:46:17",
        "is_apple_processing": false,
        "mobile_provision_file_data": "base64data", //base64格式描述文件
        "p12_file_date": "base64data" //base64格式p12证书,密码为1
    },
    "ErrorMessage": null,
    "EnErrorMessage": null,
    "ErrorCode": 0,
    "ErrorID": null
}

查询时优先查询独立池，如果存在多条udid记录，则只返回最后添加的udid的批次号。

4.查询任务批次号对应的安装地址    地址: https://www.neicexia.com/public_service/query_install_url
  Post参数:

参数名称	类型	长度限制	说明	示例
task_batch_no	string		任务批次号，添加签名任务后会返回此数据，也可以在内测侠的在线签名模块查看	CAS3A
token	string		接口token,此数据可以内测侠网站“配置自动化接口”界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded


返回结果:
{
  "IsSuccess": true,
  "Data": ["https://www.neicexia.com/v/ABNAD","https://www.neicexia.com/v/ABNAE"],
  "ErrorMessage": null,
  "ErrorCode": 0
}

5.提交企业证书签名任务: 地址: https://www.neicexia.com/public_service/create_ent_cer_sign_task
  Post参数:
  

参数名称	类型	长度限制	说明	示例
ipa_source_type	int		IPA来源: 1.服务器IPA;2.远程网址.
ipa_nos	string		ipa来源为1时可用; ipa编号，可以在内测侠网站的ipa管理中查看,如果同时签名多个ipa，则用";"分隔	EFTU6;EFTU7
ipa_url	string	200	ipa来源为2时可用; ipa的远程下载网址	http://www.yoursite.com/test.ipa
ipa_new_appid	string		ipa来源为2时可用; 新的appid;	com.company.testapp1
ipa_new_name	string		ipa来源为2时可用; 新的app名称;	测试app
cer_batch_no	string		证书批次号	3defc
task_id	string	100	用户自定义的数据，签名完成时会回传此数据	1234
info_plist_set	string	200	设置Info.plist的键值对,键值之间用":"分隔,多个键值对用";"分隔	key1:value1;key2:value2
token	string		接口token,此数据可以内测侠网站“配置自动化接口”界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded
返回数据(json)格式:
{
   "IsSuccess": true,
   "ErrorMessage": null,
   "Data": null ,
   "ErrorCode": 0
}

调用接口前，请保证在线签名余额充足。

6.检查udid批次号对应的证书是否有效    地址: https://www.neicexia.com/public_service/check_cer_validate
  Post参数:

参数名称	类型	长度限制	说明	示例
udid_batch	string		udid批次号	EASC3
token	string		接口token,此数据可以内测侠网站“配置自动化接口”界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded


返回结果:
{
  "IsSuccess": true,
  "Data": true,
  "ErrorMessage": null,
  "ErrorCode": 0
}


7.创建udid证书(不创建在线签名任务)   地址: https://www.neicexia.com/public_service/create_udid_cer
  Post参数:

参数名称	类型	长度限制	说明	示例
udid	string		设备UDID数据,多条数据需要以换行或者“;"分隔,当gain_cer_type为1时必填	c1de9900811ae4497721ab0bd86b8961959f7d12;c1de9900811ae4497721ab0bd86b8961959f7d3f
udid_region_pool	string		udid区域池,公共池:public,独立池:private,默认值:auto(当独立池可以添加udid时，优先使用独立池)	auto
udid_batch	string		udid批次号,当gain_cer_type为2时必填	EASC3
gain_cer_type	int		获取证书方式:1.新增udid ;2.查询已有的udid证书	1
use_new_account_when_apple_processing	int		当使用独立池添加的udid设备状态为苹果处理中时:1.切换新的可用账号续继添加;0:默认报错处理	1
force_use_appleid	string		当使用独立池时，可以指定强制添加udid到这个appleid.	your_appleid@icloud.com
token	string		接口token,此数据可以内测侠网站“配置自动化接口”界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded


返回结果:
{
  "IsSuccess": true,
  "Data": {
        "p12_file_date":"",  //base64格式p12证书,密码为1
        "mobile_provision_file_data":"",//.mobileprovision文件,base64格式
        "udid_batch_no":"EASC3", //udid批次号
        "cer_appleid":"" //使用的appleid,仅限独立池 
          },
  "ErrorMessage": null,
  "ErrorCode": 0
}
8.检查证书编号对应的证书是否有效    地址: https://www.neicexia.com/public_service/check_cer_validate_by_cerid
  Post参数:

参数名称	类型	长度限制	说明	示例
cer_id	string		证书编码	EASZ3
udid_region_pool	string		udid_region_pool	udid区域池,公共池:public,独立池:private
token	string		接口token,此数据可以内测侠网站“配置自动化接口”界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded


返回结果:
{
  "IsSuccess": true,
  "Data": true,
  "ErrorMessage": null,
  "ErrorCode": 0
}

9.检查p12证书文件是否有效,此接口接受json格式的post参数    地址: https://www.neicexia.com/public_service/check_p12_file_validate
  Post参数:

参数名称	类型	长度限制	说明	示例
p12_file_data	string		p12文件数据,base64编码格式	"MIIMHgIBA*******"
p12_password	string		p12文件密码

Content-type: application/x-www-form-urlencoded


返回结果:
{
  "IsSuccess": true,
  "Data": true,
  "ErrorMessage": null,
  "ErrorCode": 0
}


请用户在使用接口前先认证邮箱，自动化接口在处理中出现错误时，会将具体的错误信息发送到认证的邮箱。

babala

太赞了，有想法可惜不会技术:L